home *** CD-ROM | disk | FTP | other *** search
/ Best of Shareware / Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso / mac / DOS / EDITORS / PEDIT / PEDITDOC.EXE / PEDIT.DOC
Text File  |  1992-11-11  |  157KB  |  4,616 lines
  1.  
  2.  
  3.                        ╔══════════════════════════════════════╗
  4.                        ║                                      ║
  5.                        ║              pEDIT PLUS              ║
  6.                        ║       ────────────────────────       ║
  7.                        ║       the personal EDITor PLUS       ║
  8.                        ║                                      ║
  9.                        ║                                      ║
  10.                        ║              Version 1.1             ║
  11.                        ║                                      ║
  12.                        ║                                      ║
  13.                        ║           November 15, 1992          ║
  14.                        ║                                      ║
  15.                        ╚══════════════════════════════════════╝
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                              pEDIT  COPYRIGHT 1989 - 1992
  23.  
  24.  
  25.  
  26.                                  _______
  27.                             ____|__     |                (R)
  28.                          --|       |    |-------------------
  29.                            |   ____|__  |  Association of
  30.                            |  |       |_|  Shareware
  31.                            |__|   o   |    Professionals
  32.                          -----|   |   |---------------------
  33.                               |___|___|    MEMBER
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.                                      T. G. Muench
  48.                                     P.O. Box 11536
  49.                                Prescott, AZ 86304-1536
  50.                                     (602) 445-2479
  51.  
  52.                                     CIS 71171,2424
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.         This program is produced by a member of the Association of Share-
  70.         ware Professionals (ASP). The ASP wants to make sure that the
  71.         shareware principle works for you. If you are unable to resolve a
  72.         shareware-related problem with an ASP member by contacting the
  73.         member directly, ASP may be able to help.
  74.  
  75.         The ASP Ombudsman can help you resolve a dispute or problem with
  76.         an ASP member, but does not provide technical support for members'
  77.         products. Please write to the ASP Ombudsman at 545 Grover Road,
  78.         Muskegon MI 49442 or send a CompuServe message via CompuServe Mail
  79.         to ASP Ombudsman [70007,3536].
  80.  
  81.         The OMB may also be contacted by FAX, by sending to the ASP FAX
  82.         number: (617) 788-2765. In communicating with the OMB, please in-
  83.         clude a telephone and/or FAX number if available.
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.                                 DISCLAIMER OF WARRANTY
  91.  
  92.  
  93.               THIS SOFTWARE IS SUPPLIED AS IS. THE AUTHOR DISCLAIMS ALL
  94.                  WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
  95.              LIMITATION, THE WARRANTIES OF MERCHANTABILITY AND OF FITNESS
  96.                  FOR ANY PURPOSE. THE AUTHOR ASSUMES NO LIABILITY FOR
  97.              DAMAGES, DIRECT OR CONSEQUENTIAL, WHICH MAY RESULT FROM THE
  98.                                 USE OF THIS SOFTWARE.
  99.  
  100.  
  101.  
  102.              THIS IS A FULLY FUNCTIONING PROGRAM. IT IS NOT A DEMO NOR IS
  103.               IT CRIPPLED IN ANY WAY. ALL FEATURES ARE DOCUMENTED IN THE
  104.                ON-DISK MANUAL. IF YOU HAVE TROUBLE USING THE PROGRAM OR
  105.               FEEL YOU DID NOT RECEIVE ALL THE FILES, CONTACT THE AUTHOR
  106.                                    FOR ASSISTANCE.
  107.  
  108.  
  109.  
  110.  
  111.                            A C K N O W L E D G E M E N T S
  112.  
  113.  
  114.         The Author wishes to thank:
  115.  
  116.         Jim Hass of MicroFox Company, author of the superb DOS shell HDM-
  117.         IV. Jim has had the foresight to see the potential of pEDIT by
  118.         building support for it into HDM. He has also helped with testing
  119.         and has made many suggestions to make pEDIT the best it can be.
  120.  
  121.         Thomas G. Hanlin III, author of many assembly language libraries
  122.         for BASIC. The graphical pEDIT would not have been possible
  123.         without his GrafWiz routines which provide superfast text display
  124.         in graphics modes. These routines are now included in his BasWiz
  125.         library.
  126.  
  127.  
  128.                                 C O N V E N T I O N S
  129.  
  130.  
  131.         The following conventions are used throughout this documentation
  132.         and in the tutorial.
  133.  
  134.         pEDIT commands are shown in upper case; examples are RULER and
  135.         TRIM BUFFER. Command parameters are shown in lower case with a
  136.         vertical bar (|) separating options; an example is "SET VIDEO
  137.         text|graphics".
  138.  
  139.         Keyboard key, ButtonBar button and mouse button names are all
  140.         enclosed in angle brackets. For labelled keys, the key name cor-
  141.         responds to what is stamped on the key; examples are <Home> and
  142.         <PgDn>. An exception is the "5" key on the keypad, which is named
  143.         <Center>. The arrow keys have the names <Left>, <Right>, <Up> and
  144.         <Down>.
  145.  
  146.         Shift, Control and Alt keys are prefixed by Shift-, Ctrl-and Alt-,
  147.         respectively. The Function keys are named <F01> through <F12>.
  148.         Some older keyboards do not have the <F11> and <F12> keys. Control
  149.         keys are sometimes shown as ^X for <Ctrl-X>.
  150.  
  151.         ButtonBar buttons are referenced by their 3-character text mode
  152.         abbreviations as shown in Fig. 3; examples are <CMD>, <FND> and
  153.         <CUT>.
  154.  
  155.         The mouse button names are <MLB> and <MRB> for the left and right
  156.         buttons, respectively. pEDIT PLUS fully supports a Microsoft
  157.         compatible 2-button mouse; the middle button of a 3-button mouse
  158.         is ignored.
  159.  
  160.  
  161.  
  162.  
  163.                           T A B L E   O F   C O N T E N T S
  164.  
  165.  
  166.  
  167.         Introduction . . . . . . . . . . . . . . . . . . . . .  1
  168.  
  169.         Installing pEDIT PLUS
  170.  
  171.             1. General Information . . . . . . . . . . . . . .  3
  172.             2. Floppy Disk Installation  . . . . . . . . . . .  5
  173.             3. Hard Disk Installation  . . . . . . . . . . . .  6
  174.  
  175.          Quick Starting pEDIT PLUS
  176.  
  177.             1. Overview  . . . . . . . . . . . . . . . . . . .  8
  178.             2. Command Mode  . . . . . . . . . . . . . . . . . 12
  179.             3. Prompting Mode  . . . . . . . . . . . . . . . . 12
  180.             4. The ButtonBar . . . . . . . . . . . . . . . . . 13
  181.             5. Using a Mouse . . . . . . . . . . . . . . . . . 15
  182.  
  183.          pEDIT PLUS Commands
  184.  
  185.             1. Cursor Movement . . . . . . . . . . . . . . . . 17
  186.             2. Text Manipulation . . . . . . . . . . . . . . . 19
  187.             3. Text Deletion . . . . . . . . . . . . . . . . . 22
  188.             4. Searching . . . . . . . . . . . . . . . . . . . 23
  189.             5. Files . . . . . . . . . . . . . . . . . . . . . 25
  190.             6. Buffers . . . . . . . . . . . . . . . . . . . . 27
  191.             7. Windows . . . . . . . . . . . . . . . . . . . . 29
  192.             8. Cut and Paste . . . . . . . . . . . . . . . . . 31
  193.             9. Key Macros  . . . . . . . . . . . . . . . . . . 33
  194.            10. Miscellaneous . . . . . . . . . . . . . . . . . 35
  195.  
  196.          Macro Facility
  197.  
  198.             1. Macro Types . . . . . . . . . . . . . . . . . . 41
  199.             2. Macro Execution . . . . . . . . . . . . . . . . 41
  200.             3. Sample Macros . . . . . . . . . . . . . . . . . 41
  201.             4. Converting Disk Macros  . . . . . . . . . . . . 42
  202.  
  203.         Defining Keys in pEDIT PLUS  . . . . . . . . . . . . . 43
  204.  
  205.         Extended DOS Shell . . . . . . . . . . . . . . . . . . 44
  206.  
  207.         Drawing With pEDIT PLUS  . . . . . . . . . . . . . . . 45
  208.  
  209.         Printing From pEDIT PLUS . . . . . . . . . . . . . . . 46
  210.  
  211.         Compiling From pEDIT PLUS
  212.  
  213.             1. Manual Invocation . . . . . . . . . . . . . . . 48
  214.             2. Batch File  . . . . . . . . . . . . . . . . . . 48
  215.             3. Disk Macros . . . . . . . . . . . . . . . . . . 48
  216.  
  217.  
  218.  
  219.  
  220.  
  221.         Error Handling
  222.  
  223.             1. Insufficient Internal Storage . . . . . . . . . 50
  224.             2. Insufficient Disk Space . . . . . . . . . . . . 50
  225.             3. No Initialization File  . . . . . . . . . . . . 50
  226.  
  227.         Miscellaneous/Legalities
  228.  
  229.             1. Copyright Notice  . . . . . . . . . . . . . . . 51
  230.             2. Registration  . . . . . . . . . . . . . . . . . 51
  231.  
  232.         Appendices
  233.  
  234.             A. Key Bindings
  235.                1. Labelled Keys  . . . . . . . . . . . . . . . 52
  236.                2. Standard . . . . . . . . . . . . . . . . . . 53
  237.                3. WordStar . . . . . . . . . . . . . . . . . . 55
  238.                4. WordPerfect  . . . . . . . . . . . . . . . . 57
  239.                5. Microsoft Quick  . . . . . . . . . . . . . . 59
  240.                6. Emacs  . . . . . . . . . . . . . . . . . . . 61
  241.             B. The DOS Environment . . . . . . . . . . . . . . 63
  242.             C. Supported Video Displays  . . . . . . . . . . . 64
  243.             D. Initialization File . . . . . . . . . . . . . . 66
  244.             E. Help Files  . . . . . . . . . . . . . . . . . . 67
  245.             F. Color Codes . . . . . . . . . . . . . . . . . . 68
  246.             G. Troubleshooting . . . . . . . . . . . . . . . . 69
  247.             H. RAMEDIT . . . . . . . . . . . . . . . . . . . . 72
  248.  
  249.  
  250.  
  251.  
  252.                                I N T R O D U C T I O N
  253.  
  254.  
  255.           pEDIT PLUS is a DOS-based text editor with a graphical user
  256.         interface for the IBM Personal Computer. The program is referred
  257.         to interchangably as pEDIT PLUS, pEDIT+, and pEDIT. The program
  258.         has has been tested with MDA (monochrome text), HGA (Hercules
  259.         monochrome in text mode), CGA, EGA and VGA displays. pEDIT PLUS
  260.         requires PC/MS-DOS 2.1 or higher, 384k of memory and 720k of
  261.         floppy drive capacity; 512k memory is recommended as is a hard
  262.         disk.
  263.  
  264.           This second release of pEDIT PLUS retains the graphical Button-
  265.         Bar interface and mouse support of its predecessor. The ButtonBar
  266.         has 18 colorful "buttons" that provide fast access to the most
  267.         common editing functions. The philosophy behind the ButtonBar is
  268.         simple: it's easier to press a button than pull down a menu.
  269.  
  270.           pEDIT will handle standard ASCII text files with lines up to
  271.         32000 characters in length terminated by a carriage-return line-
  272.         feed. pEDIT is not a binary editor although it can be used to view
  273.         binary files. pEDIT PLUS is also not a word processor or desktop
  274.         publisher and does not import graphics or support multiple fonts.
  275.         pEDIT does, however, have several features normally associated
  276.         with word processors: settable margins, automatic word wrap, para-
  277.         graph reformat and justification, paragraph indent. Lines can be
  278.         centered or made flush left or right. Words (or parts of words)
  279.         can be Capitalized, lower-cased or UPPER-CASED.
  280.  
  281.           pEDIT+ has other capabilities which make it competitive with ANY
  282.         shareware editor available today: split screen editing; edit up to
  283.         16 files at one time; on-line topic help; picklists; line and box
  284.         drawing; compile without leaving the editor; and global search and
  285.         replace.
  286.  
  287.           The editor configures itself by loading an 'initialization' file
  288.         at start up. This INI file contains environment settings and key
  289.         bindings that are used to customize the editor. You can make pEDIT
  290.         PLUS work the way you want it to work... even mimic another editor
  291.         such as WordStar, WordPerfect, Microsoft's Quick Editor or Emacs.
  292.         pEDIT+ is completely configurable; if you don't like any of the
  293.         supplied configurations, modify them or create your own.
  294.  
  295.           pEDIT is unique among shareware editors in that everything is
  296.         treated as text in a buffer. Any command can be recalled from a
  297.         Command buffer, edited and reissued. And, the output from shelled
  298.         DOS commands is available in a special DOS buffer.
  299.  
  300.           There is a command line interface for those who want to use it.
  301.         It is primarily intended for commands that are used infrequently.
  302.  
  303.  
  304.  
  305.                                         - 1 -
  306.  
  307.  
  308.  
  309.         The more efficient method is to use the keyboard and, of course,
  310.         the mouse and ButtonBar.
  311.  
  312.           Every effort has been made to make pEDIT+ perform as efficiently
  313.         as possible. The speed is quite good on an AT (or higher) class
  314.         machine with a hard drive. All text is stored entirely in memory,
  315.         which makes accessing any part of the file very fast. The user can
  316.         move from the top to the bottom of any buffer instantaneously.
  317.  
  318.           Displaying text in graphics mode is normally painfully slow. For
  319.         this reason, pEDIT PLUS uses special assembly language routines
  320.         that bypass the BIOS and write directly to the hardware. However,
  321.         scrolling (which does use the BIOS) is still quite slow when
  322.         compared to text mode. For those who prefer speed to the graphical
  323.         interface, a text mode is available on all displays. Text mode
  324.         uses direct video writes for near instantaneous screen updates.
  325.  
  326.           pEDIT PLUS 1.1 has improved mouse support and the ability to
  327.         define virtually any key on the keyboard. The more standard mouse
  328.         operations include double clicking and true click and drag for
  329.         selecting text. The new keyboard interrupt handler allows for the
  330.         definition of any combination of Shift-, Ctrl- and Alt- keys. A
  331.         sample WordPerfect configuration is now included, and the STD
  332.         (Standard) configuration is now CUA-compliant. CUA, which stands
  333.         for Common User Access, is part of IBM's SAA (Systems Application
  334.         Architecture)--an attempt to standardize the user interface.
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.                                         - 2 -
  362.  
  363.  
  364.  
  365.                       I N S T A L L I N G   p E D I T   P L U S
  366.  
  367.                                 1. General Information
  368.  
  369.           The distribution diskette contains the following files. The
  370.         characters XXX in a file name represent one of the 5 supported
  371.         configurations: EMC (Emacs), QUI (Microsoft Quick Editor), STD
  372.         (Standard), WPF (WordPerfect) and WST (WordStar). An asterisk
  373.         indicates the file is included with the registered version only.
  374.  
  375.             READ.ME
  376.  
  377.               Text file containing information about the INSTALL program
  378.               and how to get started with pEDIT
  379.  
  380.             WHATS.NEW
  381.  
  382.               New features of recent releases of pEDIT and pEDIT PLUS
  383.  
  384.             PEDIT.EXE
  385.  
  386.               The pEDIT PLUS executable program
  387.  
  388.             PEDIT.BTN
  389.             PEDIT.HLP
  390.  
  391.               Button and Topic Help files
  392.  
  393.             PEDIT.SHR
  394.  
  395.               File required for internal operation of pEDIT PLUS
  396.  
  397.             PEDITDOC.EXE
  398.  
  399.               Self-extracting file which, when executed, will create
  400.               PEDIT.DOC, the complete pEDIT documentation
  401.  
  402.             PEDITCGA.BAR
  403.             PEDITMGA.BAR
  404.             PEDITEGA.BAR
  405.  
  406.               ButtonBar images for CGA, mono EGA/VGA and color EGA/VGA
  407.  
  408.             TUTORIAL.BAT
  409.             TUTORIAL.DOC
  410.             PRACTICE.TXT
  411.  
  412.               These files are used by the tutorial
  413.  
  414.             PEDITXXX.INI
  415.  
  416.  
  417.  
  418.                                         - 3 -
  419.  
  420.  
  421.  
  422.               Sample initialization files for Emacs, Microsoft Quick
  423.               Editor, Standard, WordPerfect and WordStar configurations
  424.  
  425.             PEDITXXX.KEY
  426.  
  427.               Keyboard help files to match the above initialization files
  428.  
  429.             XXXLETTR.PM1
  430.             XXXOTHUP.PM1
  431.             XXXOTHDN.PM1
  432.             XXXWREV.PM1
  433.  
  434.               Sample disk macros for each of the supported configurations
  435.  
  436.             REGISTER.DOC
  437.  
  438.               How to register for pEDIT - you can register through Public
  439.               (software) Library or directly from the author; please sup-
  440.               port shareware by registering!
  441.  
  442.             VENDOR.DOC
  443.  
  444.               Information for shareware vendors regarding requirements
  445.               for distributing pEDIT
  446.  
  447.             INSTALL.EXE
  448.  
  449.               Program to install pEDIT PLUS on your system
  450.  
  451.             RAMEDIT.BAT
  452.  
  453.               Sample batch file to copy the auxillary pEDIT files to a RAM
  454.               drive for faster operation
  455.  
  456.             PMCONVRT.EXE
  457.  
  458.               Program to convert PMC macro files to the new PM1 format;
  459.               required to convert any custom macros other than the ones
  460.               supplied with pEDIT
  461.  
  462.          (*)REGISTER.HDM
  463.  
  464.               Explains the benefits of registering the copy of HDM (Hard
  465.               Disk Menu) you'll get when you register pEDIT
  466.  
  467.          (*)KEYRATE.COM
  468.  
  469.               Program to set the keyboard repeat rate on AT and later
  470.               computers
  471.  
  472.          (*)STAYDOWN.COM
  473.  
  474.  
  475.                                         - 4 -
  476.  
  477.  
  478.  
  479.               Memory-resident utility from PC Magazine to allow Ctrl-, Alt-
  480.               and Shift- commands to be entered as 2 separate keystrokes.
  481.  
  482.           The following installation procedures assume you have a basic
  483.         knowledge of PC operation and can format a diskette. Refer to your
  484.         DOS manual as needed. There are some things to check and decisions
  485.         to make BEFORE starting the installation:
  486.  
  487.         1. If you are installing pEDIT for the first time, make sure the
  488.            target device has at least 330k of free disk space; allow
  489.            another 155k for the expanded manual
  490.  
  491.         2. If you are installing over an existing pEDIT, be sure and save
  492.            any customized INI and KEY files by renaming them to other than
  493.            PEDIT.INI and PEDIT.KEY
  494.  
  495.         3. Choose one of the supplied configurations (Standard, MS Quick,
  496.            WordPerfect, WordStar or Emacs)
  497.  
  498.         4. If you have a hard drive system, decide if you want INSTALL to
  499.            modify your AUTOEXEC.BAT file to setup the DOS PATH and PEDIT
  500.            environment variable.
  501.  
  502.         5. Decide if you want to install the optional KEYRATE and STAYDOWN
  503.            utilities (Registered version only).
  504.  
  505.         6. Decide if you want to print the tutorial documentation and run
  506.            the tutorial.
  507.  
  508.  
  509.                                2. Floppy Disk Installation
  510.  
  511.           This procedure assumes you have 2 floppy drives of at least 360k
  512.         each, or a single 720k (or 1.44MB) drive. In a dual (360k) system,
  513.         Drive A: will hold the program disk with the pEDIT executable,
  514.         initialization and help files. Drive B: will hold a work disk with
  515.         your documents, source programs or other text. In a single (720k
  516.         or 1.44MB) floppy system, everything will fit on one floppy.
  517.  
  518.           The following example is for those with two 360k drives; if you
  519.         have the 3.5" 720k floppy, format just one disk and put everything
  520.         on it.
  521.  
  522.         1. Format two diskettes; make one (the program disk) a system disk
  523.            if you want to boot from it; label the floppies 'pEDIT PLUS
  524.            Program' and 'pEDIT Work'
  525.  
  526.         2. Insert the distribution diskette in Drive A:
  527.  
  528.         3. Set default to the A: drive and run the INSTALL program
  529.  
  530.  
  531.  
  532.                                         - 5 -
  533.  
  534.  
  535.  
  536.               A>INSTALL<Enter>
  537.  
  538.         4. Remove the distribution disk from Drive A; move the pEDIT
  539.            Program Disk to Drive A and insert a pEDIT Work Disk in B:
  540.  
  541.         5. If you want KEYRATE to be run automatically when you boot, copy
  542.            KEYRATE.COM to your system disk and add the following line to
  543.            your AUTOEXEC.BAT file:
  544.  
  545.               KEYRATE FAST
  546.  
  547.         6. If you want STAYDOWN to be installed when you boot, copy
  548.            STAYDOWN.COM to the system (boot) diskette and add this line to
  549.            AUTOEXEC.BAT:
  550.  
  551.               STAYDOWN
  552.  
  553.         7. Proceed to "Quick Starting pEDIT PLUS"
  554.  
  555.  
  556.                                 3. Hard Disk Installation
  557.  
  558.           This procedure assumes you have one floppy drive and a hard disk
  559.         of any size. You will most certainly want to install pEDIT on the
  560.         hard drive for improved speed.
  561.  
  562.           If you have a hard drive system, two things MUST be set up in
  563.         your AUTOEXEC.BAT file in order for pEDIT to operate properly: (1)
  564.         the directory containing the pEDIT files must be in your DOS PATH;
  565.         (2) the environment variable PEDIT must be defined. If you choose
  566.         not to have the installation program do this for you, you must
  567.         manually edit AUTOEXEC.BAT and make the required modifications. In
  568.         either case, you must reboot for the changes to take effect.
  569.  
  570.                           ╔════════════════════════════════╗
  571.                           ║ pEDIT PLUS tip:                ║
  572.                           ║                                ║
  573.                           ║   If things don't work right   ║
  574.                           ║ after rebooting, check your    ║
  575.                           ║ AUTOEXEC.BAT file to make sure ║
  576.                           ║ the PATH and SET PEDIT state-  ║
  577.                           ║ ments are being executed.      ║
  578.                           ╚════════════════════════════════╝
  579.  
  580.           You will need to decide if you want to install pEDIT in the root
  581.         directory (\), in its own directory (\PEDIT), or in, for example,
  582.         a \TOOLS or \UTIL directory. The example assumes pEDIT will be in-
  583.         stalled from Drive A into its own directory on Drive C.
  584.  
  585.         1. Insert the distribution diskette in Drive A:
  586.  
  587.  
  588.                                         - 6 -
  589.  
  590.  
  591.  
  592.         2. Set default to the A: drive and run the installation program
  593.  
  594.               A>INSTALL<Enter>
  595.  
  596.         3. Remove the distribution disk from Drive A:
  597.  
  598.         4. Edit your AUTOEXEC.BAT file if you did not let INSTALL do it
  599.            for you. It must contain the following statements:
  600.  
  601.               PATH=...;C:\PEDIT
  602.               SET PEDIT=C:\PEDIT
  603.  
  604.         5. If you want KEYRATE to be invoked automatically when you boot,
  605.            copy KEYRATE.COM to the root directory of your hard disk and
  606.            add the following line to AUTOEXEC.BAT:
  607.  
  608.               C:\KEYRATE FAST
  609.  
  610.         6. If you want STAYDOWN to be installed when you boot, copy
  611.            STAYDOWN.COM to the root directory and add this line to
  612.            AUTOEXEC.BAT:
  613.  
  614.               C:\STAYDOWN
  615.  
  616.         7. Proceed to "Quick Starting pEDIT PLUS"
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.                                         - 7 -
  646.  
  647.  
  648.  
  649.                    Q U I C K  S T A R T I N G  p E D I T   P L U S
  650.  
  651.                                      1. Overview
  652.  
  653.           This section will give you the information you need to get up
  654.         and running with pEDIT PLUS as quickly as possible. The program
  655.         file (PEDIT.EXE) must in a directory contained in your DOS PATH,
  656.         or be in the current directory. The initialization (PEDIT.INI) and
  657.         help (PEDIT.HLP, PEDIT.BTN and PEDIT.KEY) files must be accessible
  658.         via the DOS environment or, again, be in the current directory.
  659.  
  660.           Hard drive users must define a DOS environment variable 'PEDIT'
  661.         so the editor can find the files it needs. The location of the
  662.         pEDIT files will henceforth be referred to as the PEDIT PATH; be
  663.         sure and not confuse this with the DOS PATH.
  664.  
  665.                         ╔════════════════════════════════════╗
  666.                         ║ pEDIT PLUS tip:                    ║
  667.                         ║                                    ║
  668.                         ║    See the Appendix for a full     ║
  669.                         ║ discussion of the DOS environment. ║
  670.                         ╚════════════════════════════════════╝
  671.  
  672.           If you have a floppy-only system, make sure you have a copy of
  673.         COMMAND.COM (or an alternate command processor) present. This file
  674.         must be available to use the DOS command.
  675.  
  676.           As the following examples show, pEDIT PLUS can be invoked with a
  677.         default or alternate configuration. If @XXX is not included on the
  678.         command line, pEDIT will use the default PEDIT.INI and PEDIT.KEY
  679.         files you selected. If, however, @XXX is specifed, the editor will
  680.         use the files PEDITXXX.INI and PEDITXXX.KEY. XXX represents the
  681.         alternate configuration to be used: EMC (Emacs), QUI (Quick), STD
  682.         (Standard), WPF (WordPerfect) or WST (WordStar) -or one of your
  683.         own.
  684.  
  685.           pEDIT PLUS can be started in one of two ways: with or without a
  686.         file specification. If you have a PEDIT PATH defined, the name of
  687.         the last file you edited--along with the line number and offset--
  688.         are stored in the information file PEDIT.INF. So, to call up the
  689.         last file you were editing, at the DOS prompt enter:
  690.  
  691.               C>PEDIT [@XXX]
  692.  
  693.           The normal way of starting pEDIT would be to specify a file to
  694.         be edited using either a specific or "wildcard" specification:
  695.  
  696.               C>PEDIT [@XXX] D:\PATH\FILENAME.TYP
  697.  
  698.               C>PEDIT [@XXX] D:\PATH\*.DOC
  699.  
  700.  
  701.                                         - 8 -
  702.  
  703.  
  704.  
  705.  
  706.          ┌──────────────────────────────────────────────────────────┐
  707.          ││                       ButtonBar                        ││
  708.          │├────────────────────────────────────────────────────────┤│
  709.          ││                                                         
  710.          ││                                                        ││
  711.          ││                                                        ││
  712.          ││                                                        ││
  713.          ││                                                        ││
  714.          ││                                                        ││
  715.          ││                                                        ││
  716.          ││                                                        ││
  717.          ││                                                        ││
  718.          │├────────────────────────────────────────────────────────┤│
  719.          ││  BufferName     Global    Mode   Direction   LLLL:CCCC  
  720.          │├────────────────────────────────────────────────────────┤│
  721.          ││                                                        ││
  722.          ││                                                        ││
  723.          ││                                                        ││
  724.          ││                                                        ││
  725.          ││                                                        ││
  726.          ││                                                        ││
  727.          ││                                                        ││
  728.          ││                                                        ││
  729.          ││                                                         
  730.          │└────────────────────────────────────────────────────────┘│
  731.          │   BufferName     Global    Mode   Direction   LLLL:CCCC  │
  732.          └──────────────────────────────────────────────────────────┘
  733.            Command:
  734.           <Message>                                    Working . . .
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.                                        Figure 1
  747.                                   -----------------
  748.                                   pEDIT PLUS Screen
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.                                         - 9 -
  759.  
  760.  
  761.  
  762.           If you used a wildcard specification, you will be presented with
  763.         a FILES window containing a 'pick list' of all matching filenames
  764.         (unless you see one of the "No matching files" or "Too many files"
  765.         messages).
  766.  
  767.                        ╔═════════════════════════════════════╗
  768.                        ║ pEDIT PLUS tip:                     ║
  769.                        ║                                     ║
  770.                        ║   "Too many files" means that there ║
  771.                        ║ were too many files to list in the  ║
  772.                        ║ FILES window. Narrow the search by  ║
  773.                        ║ changing '*.*' to '*.TXT', for ex-  ║
  774.                        ║ ample.                              ║
  775.                        ╚═════════════════════════════════════╝
  776.  
  777.           Once a file has been selected, the pEDIT signon screen will be
  778.         displayed. This screen will show what initialization file is being
  779.         used - provided, of course, that pEDIT can find one. Lastly, if a
  780.         matching file was found, pEDIT will load that file into the first
  781.         buffer in memory and display the first screenfull of text.
  782.  
  783.           pEDIT uses all 25 screen rows for text, status, commands and
  784.         messages. In text mode, some monitors can display more than the
  785.         standard 25 lines of text: 43 lines on EGA and VGA, and 50 lines
  786.         on VGA. The pEDIT screen can contain 1 or 2 windows. In 25-line
  787.         mode, a single window holds 19 lines of text; if the screen is
  788.         split, each window contains 9 lines.
  789.  
  790.           Figure 1 shows a representation of the pEDIT+ screen with two
  791.         windows displayed. It is important to realize that you can view
  792.         two different files or two portions of the same file when the
  793.         screen is split.
  794.  
  795.           Each window has a status line at the bottom. For a text window,
  796.         the status line shows the buffer name, the current scope (blank =
  797.         Local/Global), mode (Insert/Overstrike) and direction (Forward/-
  798.         Reverse). For an informational window, it indicates the type of
  799.         information being displayed - HELP, FILES, SHOW, LIST, ERROR, etc.
  800.  
  801.           A window can be thought of as a viewport into a portion of the
  802.         text. Figure 2 shows a text buffer (represented by the large box)
  803.         and a window into the text. A window can't show more than 78
  804.         columns of text. pEDIT uses horizontal scrolling so the window can
  805.         be into any portion of the text, not just the leftmost 78 columns.
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.                                         - 10 -
  816.  
  817.  
  818.  
  819.             ┌────────────────────────────────────────────────────────┐
  820.             │                                                        │
  821.             │        ┌────────────────┐                              │
  822.             │ Now is │the time for all│ good persons to come to the  │
  823.             │ aid of │their country.  │                              │
  824.             │        │                │                              │
  825.             │        │<─── Window ───>│                              │
  826.             │        │                │                              │
  827.             │        └────────────────┘                              │
  828.             │                                                        │
  829.             │                                                        │
  830.             │                                                        │
  831.             │                                                        │
  832.             │                                                        │
  833.             │                                                        │
  834.             │                                                        │
  835.             │<─────────────────────── Buffer ───────────────────────>│
  836.             │                                                        │
  837.             │                                                        │
  838.             │                                                        │
  839.             │                                                        │
  840.             │                                                        │
  841.             │                                                        │
  842.             │                                                        │
  843.             │                                                        │
  844.             │                                                        │
  845.             │                                                        │
  846.             │                                                        │
  847.             └────────────────────────────────────────────────────────┘
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.                                        Figure 2
  857.                                    ---------------
  858.                                    Buffers/Windows
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.                                         - 11 -
  873.  
  874.  
  875.  
  876.           The command line displayed at row 24 is actually a one line
  877.         window into the COMMAND buffer. The 'Command: ' prompt is dis-
  878.         played whenever the editor is in command mode.
  879.  
  880.           The message line at row 25 is used to display informational
  881.         text, errors, etc. Also shown at the right margin is the special
  882.         'Working . . .' message that flashes whenever pEDIT is busy
  883.         loading a file, searching, etc.
  884.  
  885.           Commands are entered either by typing them in at the command
  886.         line, by pressing a defined key, or by 'pressing' a button.
  887.         Obviously, the latter two methods are the most efficient for
  888.         functions you use all the time.
  889.  
  890.           There are some commands you need to know about in this initial
  891.         learning phase. The first is Topic HELP, which is bound to <Shift-
  892.         F01> in the Standard configuration. The second is ALTHELP (for
  893.         alternate or button and keyboard help), which is <F01>. Finally,
  894.         the command LIST KEYS displays a list of all defined keys.
  895.  
  896.  
  897.                                    2. Command Mode
  898.  
  899.           You enter Command Mode by pressing the DO COMMAND key or click-
  900.         ing the <CMD> button. The key bound to DO COMMAND depends on the
  901.         configuration you are using but is often the <Esc> key. The prompt
  902.         "Command: " is displayed on the command line and the cursor will
  903.         be positioned after the colon. At this point you can issue any
  904.         valid pEDIT command, for example WRITE FILE or SET MARGINS 10 70.
  905.         If you enter Command Mode without meaning to, simply press <Enter>
  906.         after the prompt to return to editing.
  907.  
  908.                        ╔══════════════════════════════════════╗
  909.                        ║ pEDIT PLUS tip:                      ║
  910.                        ║                                      ║
  911.                        ║   The Command line is a window into  ║
  912.                        ║ the COMMAND buffer. All defined keys ║
  913.                        ║ work the same as they do in any text ║
  914.                        ║ buffer. The mouse cannot be used on  ║
  915.                        ║ the command line.                    ║
  916.                        ╚══════════════════════════════════════╝
  917.  
  918.  
  919.                                   3. Prompting Mode
  920.  
  921.           Prompting Mode is active whenever pEDIT is asking for input and
  922.         the "Command: " prompt is not displayed. In this mode you will not
  923.         have access to all of pEDIT's commands and defined keys. Control
  924.         characters (including tabs) are represented by the Ascii character
  925.         22 (). Only Insert mode is supported; limited line editing is
  926.         available using a subset of your defined keys:
  927.  
  928.  
  929.                                         - 12 -
  930.  
  931.  
  932.  
  933.             MOVE UP          Recall the last command entered
  934.             ERASE PREV       Erase the previous character
  935.             ERASE CHAR       Erase current character
  936.             MOVE LEFT        Move cursor left one character
  937.             MOVE RIGHT       Move right one character
  938.             MOVE HOME        Position to start of line
  939.             MOVE END         Position cursor to end of line
  940.  
  941.  
  942.                                    4. The ButtonBar
  943.  
  944.           The first thing you will notice about pEDIT+ is the graphical
  945.         ButtonBar. The next thing you will notice is that there are no
  946.         menus. As explained in the Introduction, the philosophy behind the
  947.         ButtonBar is this: it is easier to press a button than pull down a
  948.         menu - which can lead to several levels of submenus.
  949.  
  950.           The ButtonBar provides, at the press of a button, 18 of the most
  951.         commonly used editing functions. In graphics mode the buttons will
  952.         be displayed in 2 (CGA), 3 (monochrome EGA/VGA) or 16 (color EGA/-
  953.         VGA) colors. The button will appear to depress when clicked on
  954.         with the mouse. You must click close to the middle of a button as
  955.         pEDIT uses row and column instead of graphics mouse coordinates.
  956.  
  957.           Accessing the ButtonBar without a mouse is clumsy at best. When
  958.         the reserved key <Shift-Esc> is pressed, the text cursor will dis-
  959.         appear and the first (leftmost) button will be "selected". The
  960.         current button is shown in reverse video (text mode) or by depres-
  961.         sing the button (graphics mode). Use the <Left> and <Right> keys
  962.         to select a button; then, press <Enter> to accept the selection or
  963.         ABORT to cancel.
  964.  
  965.           In text mode, the buttons are represented by 3-character abbrevi-
  966.         ations. Figure 3 shows a picture of the ButtonBar in text mode and
  967.         lists the function of each button.
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.                                         - 13 -
  987.  
  988.  
  989.  
  990.           ┌┬───┬───┬───┬───┬───┬───┬───┬───┬───┬
  991.           ││ < │HLP│CMD│BUF│INF│GET│WRT│FND│NXT│ /\/
  992.           └┴───┴───┴───┴───┴───┴───┴───┴───┴───┴
  993.  
  994.  
  995.                               ┬───┬───┬───┬───┬───┬───┬───┬───┬───┬┐
  996.                           \/\ │RPL│DRW│FMT│JST│CUT│PST│DOS│QUI│ > ││
  997.                               ┴───┴───┴───┴───┴───┴───┴───┴───┴───┴┘
  998.  
  999.  
  1000.  
  1001.           <        SHIFT LEFT          Shift the window left
  1002.          HLP       HELP                Bring up indexed help system
  1003.          CMD       DO COMMAND          Enter command mode
  1004.          BUF       BUFFER              Switch to another buffer
  1005.          INF       SHOW BUFFER         Info about the current buffer
  1006.          GET       GET FILE            Load a file for editing
  1007.          WRT       WRITE FILE          Save modified buffer to disk
  1008.          FND       FIND                Search for text
  1009.          NXT       FINDNEXT            Repeat the last search
  1010.          RPL       REPLACE             Replace text
  1011.          DRW       DRAW                Enter DRAWING MODE
  1012.          FMT       FILL PARA           Reformat paragraph
  1013.          JST       JUSTIFY PARA        Fully justify paragraph
  1014.          CUT       REMOVE TEXT         Cut (to clipboard)
  1015.          PST       INSERT HERE         Paste (from clipboard)
  1016.          DOS       DOS                 Shell to DOS
  1017.          QUI       QUIT                Abort the editing session
  1018.           >        SHIFT RIGHT         Shift the window right
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.                                       Figure  3
  1036.                                     -------------
  1037.                                     The ButtonBar
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.                                         - 14 -
  1044.  
  1045.  
  1046.  
  1047.                                    5. Using a Mouse
  1048.  
  1049.           pEDIT PLUS supports a Microsoft compatible 2-button mouse. The
  1050.         middle button of a 3-button mouse is ignored. Some mice support a
  1051.         proprietary mode in addition to Microsoft; be sure and set your
  1052.         rodent up in Microsoft mode. Table 1 summarizes how the mouse is
  1053.         used by pEDIT. The right mouse button is currently not used.
  1054.  
  1055.           The use of a mouse is optional. pEDIT PLUS will detect a mouse
  1056.         if one is installed and display a mouse pointer which will move
  1057.         across the screen as the mouse is moved across the desktop. The
  1058.         pointer appears as a block in text mode and an arrow in graphics
  1059.         modes.
  1060.  
  1061.                        ╔══════════════════════════════════════╗
  1062.                        ║ pEDIT PLUS tip:                      ║
  1063.                        ║                                      ║
  1064.                        ║   The text cursor and mouse pointer  ║
  1065.                        ║ are not the same! The text cursor    ║
  1066.                        ║ shows where text will be inserted.   ║
  1067.                        ╚══════════════════════════════════════╝
  1068.  
  1069.           Some mouse terminology should be explained. To "click on" an
  1070.         object means to move the mouse pointer to an object on the screen
  1071.         and press and release the specified button. To "double click" is
  1072.         to press and release the left button twice in rapid succession.
  1073.         Finally, to "click and drag" means to hold down the left mouse
  1074.         button while dragging (moving) the mouse up, down, left or right.
  1075.  
  1076.           pEDIT PLUS now supports true "click and drag" to select text.
  1077.         Hold down the left button for at least 1/2 second and then "drag"
  1078.         the mouse in any direction. Selection will be turned off if you
  1079.         click the left button elsewhere in the editing area.
  1080.  
  1081.                         ╔════════════════════════════════════╗
  1082.                         ║ pEDIT PLUS tip:                    ║
  1083.                         ║                                    ║
  1084.                         ║   Hold down the left mouse button  ║
  1085.                         ║ to repeat a mouse action such as   ║
  1086.                         ║ clicking on a button or using the  ║
  1087.                         ║ scroll bar.                        ║
  1088.                         ╚════════════════════════════════════╝
  1089.  
  1090.           The Disk Operating System (DOS) stores keystrokes in what is
  1091.         called a typeahead buffer and passes them to the application on
  1092.         request. Unfortunately, mouse presses are not 'queued' in the same
  1093.         way so you can't 'click ahead'. Don't attempt to use the mouse
  1094.         when the program is busy and the mouse pointer is turned off.
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.                                         - 15 -
  1101.  
  1102.  
  1103.  
  1104.           ┌───────────────┬─────────────────────┬────────────────────┐
  1105.           │  Location of  │   Function of Left  │ Function of Double │
  1106.           │ Mouse Pointer │     Button <MLB>    │   Clicking <MLB>   │
  1107.           ╞═══════════════╪═════════════════════╪════════════════════╡
  1108.           │               │                     │                    │
  1109.           │ In current    │   Move text cursor  │                    │
  1110.           │ text window   │   to mouse location │                    │
  1111.           │               │                     │                    │
  1112.           ├───────────────┼─────────────────────┼────────────────────┤
  1113.           │               │                     │                    │
  1114.           │ In other      │   Move text cursor  │                    │
  1115.           │ text window   │   to other window   │                    │
  1116.           │               │                     │                    │
  1117.           ├───────────────┼─────────────────────┼────────────────────┤
  1118.           │               │                     │                    │
  1119.           │ HELP, FILES   │   Highlight option  │   Select the high- │
  1120.           │ or BUFFER     │   under the mouse   │   lighted option;  │
  1121.           │ window        │   pointer           │   same as <Enter>  │
  1122.           │               │                     │                    │
  1123.           ├───────────────┼─────────────────────┼────────────────────┤
  1124.           │               │                     │                    │
  1125.           │ On UpArrow    │   Scroll up 1 line  │                    │
  1126.           │ of ScrollBar  │                     │                    │
  1127.           │               │                     │                    │
  1128.           ├───────────────┼─────────────────────┼────────────────────┤
  1129.           │               │                     │                    │
  1130.           │ On DownArrow  │   Scroll down 1     │                    │
  1131.           │ of ScrollBar  │   line              │                    │
  1132.           │               │                     │                    │
  1133.           ├───────────────┼─────────────────────┼────────────────────┤
  1134.           │               │                     │                    │
  1135.           │ Between Up-   │   Page up to the    │                    │
  1136.           │ Arrow and the │   Previous Screen   │                    │
  1137.           │ DoubleArrow   │                     │                    │
  1138.           │               │                     │                    │
  1139.           ├───────────────┼─────────────────────┼────────────────────┤
  1140.           │               │                     │                    │
  1141.           │ Between the   │   Page down to      │                    │
  1142.           │ DoubleArrow   │   the Next Screen   │                    │
  1143.           │ and DownArrow │                     │                    │
  1144.           │               │                     │                    │
  1145.           └───────────────┴─────────────────────┴────────────────────┘
  1146.  
  1147.  
  1148.  
  1149.  
  1150.                                        Table 1
  1151.                                     -------------
  1152.                                     Mouse Actions
  1153.  
  1154.  
  1155.  
  1156.  
  1157.                                         - 16 -
  1158.  
  1159.  
  1160.  
  1161.                         p E D I T   P L U S   C O M M A N D S
  1162.  
  1163.         This section lists all pEDIT commands. Each command is shown in
  1164.         uppercase and has a description following. (B) signifies the com-
  1165.         mand is a button on the ButtonBar, (M) means it is accessible with
  1166.         a mouse and (R) means it is available in registered versions only.
  1167.  
  1168.  
  1169.                                   1. Cursor Movement
  1170.  
  1171.         Moving the cursor around in the text is among the most basic of
  1172.         all editing functions. The following commands are non-destructive;
  1173.         that is, the existing text is not modified.
  1174.  
  1175.         MOVE ABSOLUTE (M)
  1176.  
  1177.         This function is accessible only with a mouse. When you click the
  1178.         <MLB> in the any text window, the text cursor will be moved to the
  1179.         location of the mouse pointer.
  1180.  
  1181.         MOVE TOP
  1182.  
  1183.         Positions the cursor to the first line of the buffer, scrolling
  1184.         or repainting the screen as necessary. pEDIT keeps all text in
  1185.         memory, making it very fast to move to the top of the buffer from
  1186.         any point in the buffer.
  1187.  
  1188.         MOVE BOTTOM
  1189.  
  1190.         Moves the cursor to the dummy last line at the end of the buffer.
  1191.         The screen will scroll or repaint as required.
  1192.  
  1193.         MOVE HOME
  1194.  
  1195.         The action of MOVE HOME depends on the position of the cursor
  1196.         within the current line. If the cursor is not at the beginning of
  1197.         a line, it will move there. If it is at the start of a line, it
  1198.         will wrap to the start of the previous line. This command is
  1199.         normally bound to the <Home> key.
  1200.  
  1201.         MOVE END
  1202.  
  1203.         The action of MOVE END depends on the position of the cursor
  1204.         within the current line. If the cursor is not at the end of the
  1205.         line, it will move there. If it is at the end of a line, it will
  1206.         wrap to the end of the next line. Normally bound to the <End> key.
  1207.  
  1208.         MOVE UP
  1209.  
  1210.         Moves the cursor up one line in the current buffer. There can be
  1211.         no action if the cursor is already on the first line of the
  1212.  
  1213.  
  1214.                                         - 17 -
  1215.  
  1216.  
  1217.  
  1218.         buffer. pEDIT keeps the cursor as close as possible to the same
  1219.         column. This command is normally bound to the <Up> key.
  1220.  
  1221.         MOVE DOWN
  1222.  
  1223.         Moves the cursor down one line in the current buffer. The cursor
  1224.         cannot move if it is already on the dummy last line of the buffer.
  1225.         pEDIT keeps the cursor as close as possible to the same column.
  1226.         This command is normally bound to the <Down> key.
  1227.  
  1228.         MOVE LEFT
  1229.  
  1230.         Moves the cursor left one character position. If the cursor is at
  1231.         the beginning of a line, it will wrap to the end of the previous
  1232.         line. Normally bound to the <Left> key.
  1233.  
  1234.         MOVE RIGHT
  1235.  
  1236.         Moves the cursor right one character position. If the cursor is at
  1237.         the end of a line, it will wrap to the beginning of the next line.
  1238.         This command is normally bound to the <Right> key.
  1239.  
  1240.         MOVE WORD
  1241.  
  1242.         Moves the cursor to the beginning of the next word in the current
  1243.         direction. If the direction is Forward, it will move toward the
  1244.         end of the buffer; if Reverse, toward the beginning of the buffer.
  1245.  
  1246.         The screen will either scroll or repaint depending on the state of
  1247.         Select. If Select is active, the screen will be redisplayed. If
  1248.         Select is not active, scrolling will take place to keep the cursor
  1249.         on the fourth line from the top or bottom of the window.
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.                                         - 18 -
  1272.  
  1273.  
  1274.  
  1275.                         p E D I T   P L U S   C O M M A N D S
  1276.  
  1277.  
  1278.                                  2. Text Manipulation
  1279.  
  1280.         These commands are used to manipulate text - insert new text and
  1281.         change the form of existing text.
  1282.  
  1283.         INSERT CHAR
  1284.  
  1285.         This is the default when one of the typing keys is pressed. In
  1286.         Insert mode, the character will be inserted into the buffer at the
  1287.         current cursor position; text to the right of the cursor is
  1288.         "shoved over" to make room. In Overstrike mode, the character is
  1289.         simply overwritten.
  1290.  
  1291.         pEDIT uses automatic word wrap to keep text between the defined
  1292.         margins as you type. If a word will not fit inside the current
  1293.         right margin, it will be moved to the start of the next line. The
  1294.         first line of a paragraph will be automatically indented if this
  1295.         parameter has been set via the SET PINDENT command.
  1296.  
  1297.         When the Tab key is pressed, the cursor will move to the next tab
  1298.         stop. Only standard tab stops at every eighth column are currently
  1299.         supported. Other control characters are displayed as the ASCII
  1300.         symbol.
  1301.  
  1302.         OPEN LINE
  1303.  
  1304.         Opens up a new (empty) line for text insertion. The end result is
  1305.         the same as pressing <Enter> followed by <Left> except that no
  1306.         indenting will take place.
  1307.  
  1308.         FILL PARA (B)
  1309.  
  1310.         Reformats a paragraph or portion of a paragraph to fit within the
  1311.         defined margins, resulting in a ragged right margin. Paragraph
  1312.         indenting is honored for the first line. Tabs are ignored. Use
  1313.         this command after you have inserted or deleted text or changed
  1314.         margins.
  1315.  
  1316.         The SET MARGINS and SET PINDENT commands are used to set the text
  1317.         margins and paragraph indent, respectively. Reformatting begins at
  1318.         the current line and stops at the end of the paragraph. A para-
  1319.         raph is defined as contiguous text bounded by empty lines both
  1320.         above and below.
  1321.  
  1322.         JUSTIFY PARA (B)
  1323.  
  1324.         Fully justifies a paragraph or portion of a paragraph to fit with-
  1325.         in the defined margins, resulting in both smooth left and right
  1326.  
  1327.  
  1328.                                         - 19 -
  1329.  
  1330.  
  1331.  
  1332.         margins. Paragraph indent is normally not used with justified text
  1333.         but is honored if set. Tabs are ignored. Text is not automatically
  1334.         justified as you type; this command is meant to be used to justify
  1335.         paragraphs after they have been entered.
  1336.  
  1337.         The SET MARGINS command is used to set the left and right margins.
  1338.         Reformatting begins at the current line and stops at the end of
  1339.         the paragraph. A paragraph is defined as contiguous text bounded
  1340.         by empty lines both above and below.
  1341.  
  1342.         INDENT
  1343.  
  1344.         This function is very useful in programming when you want to in-
  1345.         dent a section of code in or out without having to manually edit
  1346.         each line. Indenting is by levels where one level is 4 character
  1347.         positions or one-half a tab stop. INDENT uses tabs and spaces to
  1348.         indent the line to the desired offset.
  1349.  
  1350.         To use INDENT (1) position the cursor to the start of the first
  1351.         line, (2) toggle Select on, (3) highlight the entire range of
  1352.         lines to be indented and (4) issue the "INDENT" or "INDENT n"
  1353.         command. Specify the number of levels (n) as an integer - positive
  1354.         indents to the right, negative to the left.
  1355.  
  1356.         AUTO INDENT
  1357.  
  1358.         This function is very useful in programming. It is used to auto-
  1359.         matically indent a new line the same as the current line. pEDIT
  1360.         uses the same leading whitespace (spaces and tabs) as the current
  1361.         line. AUTO INDENT is normally used at the end of a line but the
  1362.         command can be issued anywhere. Normally bound to <Ctrl-Enter>.
  1363.  
  1364.         LEFT LINE
  1365.  
  1366.         Aligns the current line (the line the cursor is on) flush with
  1367.         the left margin. Only spaces are used to move the line to the
  1368.         appropriate offset.
  1369.  
  1370.         CENTER LINE
  1371.  
  1372.         Centers the current line (the line the cursor is on) between the
  1373.         defined margins. Only spaces are used to move the line to the
  1374.         appropriate offset.
  1375.  
  1376.         RIGHT LINE
  1377.  
  1378.         Adjusts the current line (the line the cursor is on) to be flush
  1379.         with the right margin. Only spaces are used to move the line to
  1380.         the appropriate offset.
  1381.  
  1382.  
  1383.  
  1384.  
  1385.                                         - 20 -
  1386.  
  1387.  
  1388.  
  1389.         CAPITAL WORD
  1390.  
  1391.         Capitalizes the current word starting at the current position
  1392.         within the word. The capitalization does not start at the begin-
  1393.         ning of the word; this is to allow, for example, 'Compuserve' to
  1394.         be changed to 'CompuServe'.
  1395.  
  1396.         LOWER WORD
  1397.  
  1398.         Converts the current word to lowercase starting at the current
  1399.         position within the word. All characters from the cursor to the
  1400.         end of the word will be changed to lowercase.
  1401.  
  1402.         UPPER WORD
  1403.  
  1404.         Converts the current word to uppercase. All characters from the
  1405.         cursor to the end of the word will be changed to uppercase.
  1406.  
  1407.         QUOTE CHAR
  1408.  
  1409.         This function is used to enter special characters into the text.
  1410.         pEDIT prompts with "Key code (1-255): "; at this point type in the
  1411.         decimal Ascii character value and press <Enter>. For example, to
  1412.         insert a form feed (Ctrl-L) you would enter the value 12.
  1413.  
  1414.         The feature can also be used with Find and Replace. To find a line
  1415.         feed (Ctrl-J) if the QUOTE CHAR key is <Ctrl-V>, press the DO
  1416.         COMMAND key and enter "FIND <Ctrl-V>10<Enter>".
  1417.  
  1418.         The LIST ASCII command displays the codes for all 255 characters.
  1419.         Extended keys such as the PC keypad and function keys cannot be
  1420.         quoted. The graphics characters (those above Ascii 127) cannot be
  1421.         entered by the very strange method of holding down the Alt key and
  1422.         entering the decimal value of the character on the numeric keypad.
  1423.  
  1424.         TRANS CHAR
  1425.  
  1426.         Transposes (swaps) two characters of text within a line. The
  1427.         cursor must be on the second character when you issue the command.
  1428.         The cursor cannot be positioned past the end of the line.
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.                                         - 21 -
  1443.  
  1444.  
  1445.  
  1446.                         p E D I T   P L U S   C O M M A N D S
  1447.  
  1448.  
  1449.                                    3. Text Deletion
  1450.  
  1451.         These commands are used to erase existing text and to restore
  1452.         deleted text. Deletion can be by character, word or line.
  1453.  
  1454.         ERASE CHAR
  1455.  
  1456.         Deletes the current character, i.e. the character the cursor is
  1457.         on. The action is dependent on the current mode. In Insert mode,
  1458.         the character is deleted and text to the right of the cursor is
  1459.         shifted left to "fill in the hole". In Overstrike mode, the char-
  1460.         acter is replaced by a space.
  1461.  
  1462.         ERASE PREV
  1463.  
  1464.         Deletes the previous character - the character to the left of the
  1465.         cursor. In Insert mode, the character is deleted and text to the
  1466.         right of the cursor is again shifted toward the left. In Over-
  1467.         strike mode, the character is replaced by a space. The command is
  1468.         permanently bound to the <BackSpace> key.
  1469.  
  1470.         ERASE WORD
  1471.  
  1472.         Deletes text from the current position in a word to the end of the
  1473.         word. The current mode and direction have no effect on the action
  1474.         taken; deletion is always toward the end of the word.
  1475.  
  1476.         ERASE LINE
  1477.  
  1478.         Erases a line or portion of a line. If the cursor is at the begin-
  1479.         ning of a line, the entire line (including the end of line marker)
  1480.         is erased and stored in the text buffer. If the cursor is not at
  1481.         the beginning of a line, deletion is from the current position to
  1482.         the end of the line.
  1483.  
  1484.         RESTORE TEXT
  1485.  
  1486.         Restores the text last deleted by ERASE WORD or ERASE LINE. This
  1487.         text is stored in a special text buffer for later restoration.
  1488.         This text buffer is rebuilt after every action so only the last
  1489.         erasure can be restored.
  1490.  
  1491.         This command along with REMOVE TEXT provide an "undo" capability.
  1492.         It is very unlikely that anyone would ever need to "undo" hundreds
  1493.         of editing operations. A better approach is to "Save early, save
  1494.         often" so you can fall back to the point of the last save.
  1495.  
  1496.  
  1497.  
  1498.  
  1499.                                         - 22 -
  1500.  
  1501.  
  1502.  
  1503.                         p E D I T   P L U S   C O M M A N D S
  1504.  
  1505.  
  1506.                                      4. Searching
  1507.  
  1508.         These commands are used to search for text and to replace one text
  1509.         string by another. A limited wild card facility permits matching
  1510.         the beginning and end of line. The SET SCOPE command determines if
  1511.         the searching is to be local (the current buffer) or global (all
  1512.         buffers).
  1513.  
  1514.         FIND (B)
  1515.  
  1516.         FIND is used to search for a text string. To initiate this func-
  1517.         tion, press the FIND key and respond to "String to find", or press
  1518.         DO COMMAND and enter "FIND <text>". The direction of the search
  1519.         will be in the current direction. You can cancel an active FIND
  1520.         operation by pressing the ABORT key.
  1521.  
  1522.         If the target string is all lowercase, the operation will be case-
  1523.         insensitive; that is 'pedit' will match all of 'pedit', 'pEDIT'
  1524.         and 'PEDIT'. If, however, the target contains any uppercase
  1525.         characters, the match will be exact, i.e. 'pEDIT' matches only
  1526.         'pEDIT'.
  1527.  
  1528.         Special symbols are used to match beginning of line (bol) and end
  1529.         of line (eol). Use '\\<' for bol and '\\>' for eol. For example,
  1530.         '.\\>' matches a period only if it is at the end of a line.
  1531.  
  1532.         FINDNEXT (B)
  1533.  
  1534.         Searches for the next occurrence of the last search string you
  1535.         specified. It is best to have FINDNEXT bound to a key so only a
  1536.         single key press is required to repeat the last search operation.
  1537.  
  1538.         REPLACE (B)
  1539.  
  1540.         pEDIT has a very powerful search and replace function. To initiate
  1541.         it, either press the REPLACE key and reply to the "Old string:"
  1542.         and "New string:" prompts, or press DO COMMAND and enter "REPLACE
  1543.         <old> <new>".
  1544.  
  1545.         pEDIT will search for each occurrence of 'old' and prompt you with
  1546.         "Replace (Y)es (N)o (A)ll (L)ast (Q)uit: "
  1547.  
  1548.             Y, Enter - replace this occurrence
  1549.             N        - skip this replacement
  1550.             A        - replace all occurrences from this point
  1551.             L        - make this the last replacement and quit
  1552.             Q        - quit.
  1553.  
  1554.  
  1555.  
  1556.                                         - 23 -
  1557.  
  1558.  
  1559.  
  1560.         Matching the old string will follow the rules listed for the FIND
  1561.         command. The same wild cards that are useable in FIND may be
  1562.         specified for the 'old' string only.
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.  
  1594.  
  1595.  
  1596.  
  1597.  
  1598.  
  1599.  
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.                                         - 24 -
  1614.  
  1615.  
  1616.  
  1617.                         p E D I T   P L U S   C O M M A N D S
  1618.  
  1619.  
  1620.                                        5. Files
  1621.  
  1622.         These commands pertain to the reading and writing of disk files.
  1623.         You can load in a file, save a buffer to disk and change the file
  1624.         name associated with a buffer.
  1625.  
  1626.         Up to 16 files can be loaded at one time. Note that a buffer can-
  1627.         not be "released" because pEDIT cannot currently free up memory
  1628.         once it has been allocated.
  1629.  
  1630.         GET FILE (B)
  1631.  
  1632.         Loads in a file from disk for editing. pEDIT supports wildcard
  1633.         file specifications of the type '*.*' and '*.TXT'. If more than
  1634.         one file matches the specification, you will be presented with a
  1635.         list of all matching file names in alpha order. To select a file,
  1636.         use the arrow keys, type in the first letter, or click on it with
  1637.         the left mouse button. Press <Enter> or double click to load the
  1638.         highlighted file. Press the ABORT key to cancel.
  1639.  
  1640.         If no matching file exists, pEDIT will display "Creating file". If
  1641.         the file does exist, it will be loaded into memory. It is very
  1642.         important to realize that the file itself is still on disk and
  1643.         will remain unchanged unless you save a modified buffer using the
  1644.         WRITE FILE command.
  1645.  
  1646.         INCLUDE FILE
  1647.  
  1648.         Reads in the specified file from disk and inserts it into the
  1649.         buffer starting at the current cursor location. The result is the
  1650.         same as if the user typed in the text contained in the file.
  1651.  
  1652.         INCLUDE FILE should be used only for relatively small files. The
  1653.         function uses the normal INSERT CHAR routine, not the much faster
  1654.         GET FILE which loads text directly into memory.
  1655.  
  1656.         WRITE FILE (B)
  1657.  
  1658.         Saves the contents of the current buffer to disk without ending
  1659.         the editing session. If a file name has not yet been specified,
  1660.         pEDIT will ask for one.
  1661.  
  1662.         pEDIT PLUS verifies that there is sufficient disk space BEFORE
  1663.         starting the save operation. The Error Handling Section has a full
  1664.         description of what to do if you get an error while saving a file.
  1665.  
  1666.         You can change the name of the associated file at any time by
  1667.         using the RENAME FILE command.
  1668.  
  1669.  
  1670.                                         - 25 -
  1671.  
  1672.  
  1673.  
  1674.         RENAME FILE
  1675.  
  1676.         Changes the name of the disk file associated with the current
  1677.         buffer. The new name will be used at the time of the next WRITE
  1678.         FILE operation. The buffer name is also changed to reflect the
  1679.         new file name if that buffer name is not already in use.
  1680.  
  1681.         Use RENAME FILE when you want to save a file under a name other
  1682.         than the one the it was called up under.
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.                                         - 26 -
  1728.  
  1729.  
  1730.  
  1731.                         p E D I T   P L U S   C O M M A N D S
  1732.  
  1733.  
  1734.                                       6. Buffers
  1735.  
  1736.         These commands affect how text is viewed. You can pick which
  1737.         buffer to view, set the mode and direction for a buffer, and so
  1738.         on.
  1739.  
  1740.         SHOW BUFFER (B)
  1741.  
  1742.         Displays detailed information about the current buffer: the buffer
  1743.         name, associated file name, current mode/direction, number of
  1744.         lines and characters of text, etc. The status line also shows the
  1745.         pEDIT version number.
  1746.  
  1747.         BUFFER (B)
  1748.  
  1749.         Use this command to switch between buffers. You will be presented
  1750.         with a BUFFER window containing the names of all buffers except
  1751.         the COMMAND buffer. The name of the first User buffer will be
  1752.         highlighted. To select a buffer, use the up and down arrow keys,
  1753.         type in the first letter of a buffer name or click on the name.
  1754.         Press <Enter> or double click to move to the selected buffer. You
  1755.         can also Press ABORT to cancel.
  1756.  
  1757.         TRIM BUFFER
  1758.  
  1759.         This function 'trims' the current buffer by removing trailing
  1760.         blanks from all lines of text.
  1761.  
  1762.         TRIM BUFFER is useful in any document where a left margin has been
  1763.         defined. pEDIT automatically indents every line to the specified
  1764.         left margin, which can result in "empty" lines between paragraphs.
  1765.         These empty lines can take up a lot of space in a large document.
  1766.  
  1767.         CHANGE MODE
  1768.  
  1769.         Used to toggle between Insert and Overstrike modes. If the mode is
  1770.         Insert when the command is given, it will change to Overstrike and
  1771.         vice versa.
  1772.  
  1773.         CHANGE DIR
  1774.  
  1775.         Use this command to toggle between the Forward and Reverse
  1776.         directions. Note that only FIND, FINDNEXT, REPLACE and MOVE WORD
  1777.         use the buffer direction.
  1778.  
  1779.         MARK
  1780.  
  1781.         Used to mark a particular place in a buffer so you can return to
  1782.  
  1783.  
  1784.                                         - 27 -
  1785.  
  1786.  
  1787.  
  1788.         it at some later time. Sometimes called a bookmark; there can be
  1789.         only one marker in each buffer. pEDIT tries to stay as close as
  1790.         possible to the original mark as text is inserted and deleted.
  1791.  
  1792.         GOTO MARK
  1793.  
  1794.         This command moves to the position (line and offset) defined by
  1795.         the last MARK command.
  1796.  
  1797.         LINE
  1798.  
  1799.         The LINE command is used to "goto" a particular line in the cur-
  1800.         rent buffer. Enter "LINE nn" to move to line number nn; if you
  1801.         enter LINE by itself, pEDIT will prompt for a line number.
  1802.  
  1803.  
  1804.  
  1805.  
  1806.  
  1807.  
  1808.  
  1809.  
  1810.  
  1811.  
  1812.  
  1813.  
  1814.  
  1815.  
  1816.  
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.                                         - 28 -
  1842.  
  1843.  
  1844.  
  1845.                         p E D I T   P L U S   C O M M A N D S
  1846.  
  1847.  
  1848.                                       7. Windows
  1849.  
  1850.         The window functions control the number of windows on screen and
  1851.         let you select the current window. A window can be panned up,
  1852.         down, left or right to view any portion of a buffer.
  1853.  
  1854.         ONE WINDOW
  1855.  
  1856.         This function 'unsplits' the screen. If there are 2 windows on
  1857.         screen, the current window - the one the cursor is in - becomes
  1858.         the only window. The current window will occupy the full screen.
  1859.         The line the cursor was on when the command was issued becomes the
  1860.         top line of the window.
  1861.  
  1862.         TWO WINDOWS
  1863.  
  1864.         'Splits' the screen if there is only one window visible. Both
  1865.         windows will initially show the same number of lines of the
  1866.         current buffer. The cursor will be moved to the other window,
  1867.         anticipating that you want to load in another file.
  1868.  
  1869.         OTHER WINDOW (M)
  1870.  
  1871.         If the screen is split, this command will move the cursor to the
  1872.         other window. The cursor will move to the row and column stored
  1873.         the last time the cursor was in the window.
  1874.  
  1875.         If you have a mouse, click anywhere in the other window to move to
  1876.         that window.
  1877.  
  1878.         PREV LINE (M)
  1879.  
  1880.         Scrolls the current window up one line. This command is normally
  1881.         accessed only with a mouse, by clicking on the UpArrow symbol at
  1882.         the top of the Scroll Bar.
  1883.  
  1884.         PREV SCREEN (M)
  1885.  
  1886.         Moves the text window back one screen towards the beginning of the
  1887.         buffer. This command should be bound to the <PgUp> key as it means
  1888.         "Page Up". The screen is repainted rather than scrolled.
  1889.  
  1890.         NEXT LINE (M)
  1891.  
  1892.         Scrolls the current window down one line. This command is normally
  1893.         accessed only with a mouse, by clicking on the DownArrow symbol at
  1894.         the bottom of the Scroll Bar.
  1895.  
  1896.  
  1897.  
  1898.                                         - 29 -
  1899.  
  1900.  
  1901.  
  1902.         NEXT SCREEN (M)
  1903.  
  1904.         Moves the text window forward one screen towards the end of the
  1905.         buffer. This command should remain bound to the <PgDn> key as it
  1906.         means "Page Down". Again, the screen is repainted rather than
  1907.         scrolled.
  1908.  
  1909.         SHIFT LEFT (B)
  1910.  
  1911.         Moves the window horizontally to the left (toward the left margin)
  1912.         the specified number of columns. If no parameter is specified, the
  1913.         shift amount will be 40 columns.
  1914.  
  1915.         SHIFT RIGHT (B)
  1916.  
  1917.         Shifts the screen horizontally to the right - toward the end of
  1918.         the line - by the number of columns you specify. This is to permit
  1919.         viewing text past column 78. If no argument is specified, the
  1920.         screen will be shifted 40 columns. The shift value is limited only
  1921.         by the maximum line length of 32767 characters.
  1922.  
  1923.  
  1924.  
  1925.  
  1926.  
  1927.  
  1928.  
  1929.  
  1930.  
  1931.  
  1932.  
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.  
  1949.  
  1950.  
  1951.  
  1952.  
  1953.  
  1954.  
  1955.                                         - 30 -
  1956.  
  1957.  
  1958.  
  1959.                         p E D I T   P L U S   C O M M A N D S
  1960.  
  1961.  
  1962.                                    8. Cut and Paste
  1963.  
  1964.         pEDIT provides another "undo" capability in addition to restoring
  1965.         erased text. A block of text can be "cut" and stored in a "paste"
  1966.         buffer (also called the clipboard) for later retrieval. Other com-
  1967.         mands are available to copy the selected text without removing it,
  1968.         and to delete text without storing it.
  1969.  
  1970.         Important: the maximum size of a block that can be stored on the
  1971.         clipboard using the REMOVE TEXT and STORE TEXT commands is limited
  1972.         by available memory.
  1973.  
  1974.         SELECT TEXT (M)
  1975.  
  1976.         This is a toggle that turns the select state on/off. If the state
  1977.         is off, it will be turned on and vice versa. Selected text is
  1978.         highlighted in reverse video as the cursor is moved. Select is
  1979.         automatically turned off after REMOVE TEXT, STORE TEXT and WIPE
  1980.         TEXT commands. To cancel the selection, i.e. turn the highlighting
  1981.         off, simply issue the command again.
  1982.  
  1983.         To select text with the mouse, move the mouse pointer to the start
  1984.         of the desired block. Hold the left button down for at least 1/2
  1985.         second, then "drag" the mouse in any direction while continuing
  1986.         to hold the left button down. You can even scroll up or down while
  1987.         selecting by dragging the mouse pointer to the row just above or
  1988.         below the text window.
  1989.  
  1990.         REMOVE TEXT (B)
  1991.  
  1992.         Removes (cuts) the selected text and stores it to the clipboard
  1993.         (paste buffer). The clipboard is rebuilt every time REMOVE TEXT is
  1994.         invoked; therefore, only the most recently deleted text can be
  1995.         reclaimed.
  1996.  
  1997.         STORE TEXT
  1998.  
  1999.         Copies the selected text to the clipboard without removing from
  2000.         the buffer. Use this command whenever you want to make a copy of
  2001.         some text without deleting it.
  2002.  
  2003.         WIPE TEXT
  2004.  
  2005.         Deletes the highlighted block without copying it to the clipboard.
  2006.         WIPE TEXT is much faster than REMOVE TEXT because the paste buffer
  2007.         does not have to be rebuilt. This command is especially useful for
  2008.         deleting large amounts of text; use it when you have no need to
  2009.         get the text back. There is no limit on the size of the block that
  2010.         can be erased.
  2011.  
  2012.                                         - 31 -
  2013.  
  2014.  
  2015.  
  2016.         INSERT HERE (B)
  2017.  
  2018.         Inserts text from the clipboard into the current buffer starting
  2019.         at the current cursor position. Note that INSERT HERE can be in-
  2020.         voked more than once to make multiple copies of the stored text.
  2021.  
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.  
  2067.  
  2068.  
  2069.                                         - 32 -
  2070.  
  2071.  
  2072.  
  2073.                         p E D I T   P L U S   C O M M A N D S
  2074.  
  2075.  
  2076.                                     9. Key Macros
  2077.  
  2078.         pEDIT's key macro facility lets you automate repetitive tasks.
  2079.         With the following commands you can start a "learn" sequence and
  2080.         pEDIT will "remember" all the keystrokes that were entered. You
  2081.         can then "play back" the macro to replay the keystrokes.
  2082.  
  2083.         Key macros can be saved permanently to disk, making it possible to
  2084.         have several pre-defined macros available for use.
  2085.  
  2086.         LEARN
  2087.  
  2088.         The LEARN command is used to start recording keystrokes. The rec-
  2089.         ording will continue until the REMEMBER command is given. pEDIT
  2090.         will store all typing keys, function keys and special keys such as
  2091.         control keys. Note that mouse button presses are not stored.
  2092.  
  2093.         Any key can be stored in a pEDIT macro. The only restriction is
  2094.         that a macro containing a REPEAT command cannot itself be repeated.
  2095.  
  2096.         REMEMBER
  2097.  
  2098.         Used to end the keystroke recording started by LEARN. pEDIT will
  2099.         ask for a key to bind to; press any of the definable keys on the
  2100.         keyboard. You cannot bind to the Tab, Enter or BackSpace keys.
  2101.  
  2102.         A macro must also not be bound to a key that is contained within
  2103.         the macro. If this happens, the macro routine will go into a loop
  2104.         and probably crash the system.
  2105.  
  2106.         SAVE MACRO
  2107.  
  2108.         Saves the currently defined key macro to disk. Enter only a file
  2109.         name; pEDIT automatically adds the extension .PM1. The editor will
  2110.         write the macro file in the directory pointed to by the current
  2111.         PEDIT PATH.
  2112.  
  2113.         If a macro file of the same name already exists, you will be given
  2114.         the chance to overwrite it or cancel.
  2115.  
  2116.         EXECUTE
  2117.  
  2118.         Executes the macro previously defined by LEARN and REMEMBER. When
  2119.         this command is issued, the keystrokes are 'replayed' as if you
  2120.         entered them. There are two forms of this command: one for a key
  2121.         macro, one for a disk macro. See the 'Macro Facility' section for
  2122.         more information.
  2123.  
  2124.  
  2125.  
  2126.                                         - 33 -
  2127.  
  2128.  
  2129.  
  2130.         EXECUTE by itself is used for the single key macro. A command of
  2131.         the form "EXECUTE filename" invokes a disk macro. Here, "filename"
  2132.         is a valid DOS file name up to 8 characters in length without an
  2133.         extension. pEDIT automatically adds the file type .PM1 to all disk
  2134.         macro file names.
  2135.  
  2136.  
  2137.  
  2138.  
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.                                         - 34 -
  2184.  
  2185.  
  2186.  
  2187.                         p E D I T   P L U S   C O M M A N D S
  2188.  
  2189.                                   10. Miscellaneous
  2190.  
  2191.         DO COMMAND (B)
  2192.  
  2193.         When the "DO" key is pressed the editor will respond with the
  2194.         'Command: ' prompt. At this point you can enter any valid pEDIT
  2195.         command. Commands can be upper- or lower-case or mixed. Note that
  2196.         commands must be entered in full with spaces in between words. You
  2197.         can exit Command Mode without doing anything by pressing <Enter>
  2198.         after the prompt.
  2199.  
  2200.         The Command line is a one-line window into the COMMAND buffer. All
  2201.         defined keys can be used on the command line for editing the cur-
  2202.         rent line. Use MOVE UP and MOVE DOWN to scroll through the stored
  2203.         commands.
  2204.  
  2205.         RECALL
  2206.  
  2207.         Used to recall the last command given via DO COMMAND. The end
  2208.         result is the same as pressing the DO COMMAND key followed by the
  2209.         MOVE UP with one important difference; the previous command is
  2210.         copied to the current command line. The command can of course be
  2211.         edited before pressing <Enter> to begin execution.
  2212.  
  2213.         DO BUTTON
  2214.  
  2215.         Permits keyboard access to the ButtonBar for those users without a
  2216.         mouse. This function is permanently bound to the <Shift-Esc> key
  2217.         and should not be issued from the command line. When this key is
  2218.         pressed, the first button will be selected and pEDIT will wait for
  2219.         your input. Use the <Left> and <Right> keys to move from button-to-
  2220.         button, and press <Enter> to accept or ABORT to cancel.
  2221.  
  2222.         ABORT
  2223.  
  2224.         pEDIT has a user-definable ABORT key which must be defined in the
  2225.         initialization file. The actual key used depends on the configur-
  2226.         ation; ABORT is not 'hard-wired' to <Ctrl-C> because WordStar uses
  2227.         <Ctrl-C> as a command key.
  2228.  
  2229.         ABORT can be used to abort out of any REPEAT, FIND, FINDNEXT or
  2230.         REPLACE loop. You can also use it to cancel out of the DO BUTTON
  2231.         function, or any BUFFER, FILES or HELP screen.
  2232.  
  2233.         REFRESH SCREEN
  2234.  
  2235.         This command is used to clear and repaint the screen. Use REFRESH
  2236.         SCREEN if, for any reason, the screen should be overwritten or
  2237.         otherwise obliterated.
  2238.  
  2239.  
  2240.                                         - 35 -
  2241.  
  2242.  
  2243.  
  2244.         DEFINE SHIFT
  2245.  
  2246.         Defines a shift or "lead-in" key for multi-key commands. pEDIT
  2247.         must know when to wait for a second keystroke. A shift key cannot
  2248.         be a command key by itself.
  2249.  
  2250.         The shift keys must be defined in your initialization file before
  2251.         other key definitions. Any non-typing key can be a shift key; a
  2252.         maximum of 4 shift keys can be defined.
  2253.  
  2254.         DEFINE KEY
  2255.  
  2256.         Used to 'bind' a pEDIT command to the key of your choice. Pressing
  2257.         the specified key is equivalent to pressing DO COMMAND and typing
  2258.         in the associated command. Here, 'command' refers to any valid
  2259.         pEDIT command entered in full (no abbreviations) with or without
  2260.         parameters.
  2261.  
  2262.         Keys can be defined dynamically during an editing session or, more
  2263.         commonly, specified in your init file. When DEFINE KEY is issued
  2264.         from within the editor, pEDIT will ask for a procedure name and a
  2265.         key press.
  2266.  
  2267.         SHOW KEY
  2268.  
  2269.         Displays the command bound to a key. pEDIT will prompt for a key
  2270.         press and display the full command string, if there is one, bound
  2271.         to that key.
  2272.  
  2273.         LIST KEYS
  2274.  
  2275.         Lists all defined keys and the commands bound to them. pEDIT will
  2276.         pause in between screens; press any key to continue to the next
  2277.         screen.
  2278.  
  2279.         LIST ASCII
  2280.  
  2281.         Displays the complete ASCII character set used by the IBM PC. In-
  2282.         cludes the decimal value (1-255), the hexadecimal or "HEX" value
  2283.         (01H to FFH) and the character. Very handy for programmers. The
  2284.         editor will pause in between screens; press any key to continue to
  2285.         the next screen.
  2286.  
  2287.         DRAW (B)
  2288.  
  2289.         This function is used to draw lines and boxes on the screen. The
  2290.         Mode and Direction indicators on the Status Bar are replaced by
  2291.         the text "** DRAWING MODE **". Only a subset of the defined keys
  2292.         are recognized:
  2293.  
  2294.             ABORT            Exit drawing mode and return to editing
  2295.  
  2296.  
  2297.                                         - 36 -
  2298.  
  2299.  
  2300.  
  2301.             MOVE UP          Move up one line, padding if necessary
  2302.             MOVE DOWN        Move down one line, padding if necessary
  2303.             MOVE LEFT        Move cursor left one column
  2304.             MOVE RIGHT       Move right one column with padding
  2305.             MOVE HOME        Position to start of line
  2306.             MOVE END         Position cursor to end of line
  2307.             -                Draw a single line/box using graphics chars
  2308.             =                Draw a double line/box using graphics chars
  2309.             +                Draw a line or box using standard chars
  2310.  
  2311.         See the section 'Drawing With pEDIT PLUS' for more information.
  2312.  
  2313.         REPEAT
  2314.  
  2315.         Lets you repeat any key press up to 32767 times. Only the next
  2316.         single key press is repeated.
  2317.  
  2318.         The repeat count is shown by 'Repeat: ' on the message line. Use
  2319.         <BackSpace> to correct the count; set the count to zero if you
  2320.         wish to cancel.
  2321.  
  2322.         You can exit a REPEAT loop by pressing the ABORT key.
  2323.  
  2324.         SET AUTOSAVE
  2325.  
  2326.         The autosave feature can be used to automatically save your work
  2327.         to disk. If autosave is active, a WRITE FILE will be performed
  2328.         periodically to the current buffer if changes have been made. The
  2329.         buffer will also be saved when a new file is loaded or you switch
  2330.         buffers.
  2331.  
  2332.         The usage is "SET AUTOSAVE value". A value of zero turns the
  2333.         autosave feature off; a value in the range 1-30 defines a save
  2334.         interval of 1 to 30 minutes.
  2335.  
  2336.         SET COLOR
  2337.  
  2338.         Lets you choose foreground and background colors for your editing
  2339.         session. For monochrome and CGA displays, the only legal color
  2340.         combinations are Black-on-White and White-on-Black.
  2341.  
  2342.         Only the basic 16 colors are supported on EGA/VGA color displays.
  2343.         The usage is "SET COLOR fground bground". See the Appendix for a
  2344.         list of color codes.
  2345.  
  2346.         SET CURSOR
  2347.  
  2348.         Lets you choose an underline or block cursor style to suit your
  2349.         personal needs. The usage is "SET CURSOR uline|block".
  2350.  
  2351.         SET DISPLAY
  2352.  
  2353.  
  2354.                                         - 37 -
  2355.  
  2356.  
  2357.  
  2358.         Used to override pEDIT's video display type detection. This com-
  2359.         mand can only be used in the initialization file. Use it only if
  2360.         pEDIT cannot correctly identify your video type. The syntax is
  2361.         "SET (DISPLAY, n)" where n = 0 (text); 2 (CGA); 9 (color EGA/VGA);
  2362.         10 (mono EGA/VGA).
  2363.  
  2364.         SET LINES
  2365.  
  2366.         Lets you choose the number of lines of text that are shown on-
  2367.         screen. All displays support 25 lines; 43 line mode requires EGA
  2368.         or VGA, while 50 line mode (text mode only) requires VGA. Screen
  2369.         writing and scrolling are generally much slower in 43-and 50-line
  2370.         modes. This command cannot be used when the screen is split. The
  2371.         usage is "SET LINES 25|43|50".
  2372.  
  2373.         SET MARGINS
  2374.  
  2375.         Lets you set left and right text margins; the right margin con-
  2376.         trols where text wraps. The default margins are 1 and 80. The left
  2377.         margin must be greater than zero and the right margin has to be
  2378.         greater than the left. The usage is "SET MARGINS left right".
  2379.  
  2380.         SET PINDENT
  2381.  
  2382.         Used to set the paragraph indent, i.e. the number of columns by
  2383.         which to indent the first line of a paragraph. The usage is "SET
  2384.         PINDNT nn" where nn is zero or a positive integer.
  2385.  
  2386.         SET SCOPE
  2387.  
  2388.         Specifies the "scope" for all FIND and REPLACE operations. If the
  2389.         scope is Local, only the current buffer will be searched. If how-
  2390.         ever the scope is Global, all user buffers will be searched and
  2391.         'Global' will show on the status line. The format of this command
  2392.         is "SET SCOPE local|global".
  2393.  
  2394.         Things can quickly get out of hand if some buffers are searched in
  2395.         a forward direction while others are searched in reverse. For this
  2396.         reason, the direction for all buffers is temporarily set to
  2397.         Forward during a global search.
  2398.  
  2399.         SET VIDEO
  2400.  
  2401.         Lets you switch between text and graphics mode if you have a
  2402.         graphics display. pEDIT PLUS will start up in graphics mode if it
  2403.         detects a CGA/EGA/VGA display; you can override this if you prefer
  2404.         the speed of text mode to the graphical interface. The usage is
  2405.         "SET VIDEO text|graphics".
  2406.  
  2407.         PRINT (R)
  2408.  
  2409.  
  2410.  
  2411.                                         - 38 -
  2412.  
  2413.  
  2414.  
  2415.         Provides the ability to print directly from within pEDIT PLUS.
  2416.         This is done by interfacing to the PRINT utility included with DOS
  2417.         3.0 and greater. This function is available only in registered
  2418.         versions of pEDIT. Use this command to print the contents of the
  2419.         current buffer, print a selected portion of the current buffer,
  2420.         delete a file from the print queue or cancel all print jobs in the
  2421.         queue. The syntax is "PRINT buffer|block|delete|cancel".
  2422.  
  2423.         If the printer is off-line or out of paper, the PRINT DELETE and
  2424.         PRINT CANCEL commands may not complete correctly. pEDIT should
  2425.         resume after the problem is fixed. See the section 'Printing from
  2426.         pEDIT PLUS' for more information.
  2427.  
  2428.         SHOW PRINTER (R)
  2429.  
  2430.         Displays the status of all jobs in the print queue in a special
  2431.         PRINTER window. pEDIT shows a maximum of 10 jobs; this is the
  2432.         default number of queue entries in the DOS PRINT utility. If there
  2433.         are more than 10 files queued - the maximum is 32 - they will not
  2434.         be shown. Press any key or mouse button to return to editing.
  2435.  
  2436.         DOS (B)
  2437.  
  2438.         This function 'shells' you to DOS or passes a command to DOS for
  2439.         execution. All text is swapped out to disk, and a second copy of
  2440.         the command processor is loaded to process commands. Refer to the
  2441.         section 'Extended DOS Shell' for more information.
  2442.  
  2443.         If "DOS" is given without parameters, you will be shelled to DOS
  2444.         and will see the DOS prompt. You may then enter DOS commands and
  2445.         do anything you can do at the operating system level. Type 'EXIT'
  2446.         to return to the editor exactly as you left it.
  2447.  
  2448.         If parameters are specified, the command will be passed to DOS for
  2449.         execution and the output will be shown in the DOS buffer.
  2450.  
  2451.         HELP (B)
  2452.  
  2453.         Provides complete on-line help for every pEDIT PLUS command. pEDIT
  2454.         looks for a help file named PEDIT.HLP in the directory pointed to
  2455.         by the PEDIT PATH.
  2456.  
  2457.         You will be presented with a HELP window containing an alpha list
  2458.         of all pEDIT commands. Use the arrow keys, press the first letter
  2459.         of the command or click the left mouse button to highlight the
  2460.         topic you want help with; press <Enter> or double click to select
  2461.         that topic. The function can be cancelled by pressing the ABORT
  2462.         key.
  2463.  
  2464.         ALTHELP
  2465.  
  2466.  
  2467.  
  2468.                                         - 39 -
  2469.  
  2470.  
  2471.  
  2472.         Displays the contents of the files PEDIT.BTN and PEDIT.KEY in
  2473.         BUTTON and KEYBOARD windows, respectively. The editor looks for
  2474.         these two files in the directory specified by the PEDIT PATH.
  2475.  
  2476.         Provides help for the ButtonBar and the keyboard (usually a
  2477.         keyboard diagram and/or a list of the keys you have defined).
  2478.  
  2479.         RULER
  2480.  
  2481.         Toggles an on-screen ruler on and off. The ruler temporarily over-
  2482.         writes the status line at the bottom of the window.
  2483.  
  2484.         QUIT (B)
  2485.  
  2486.         Aborts an editing session. Abort MEANS abort - any changes you
  2487.         have made will be lost. If any User (non-system) buffers have been
  2488.         modified, pEDIT gives you the option of not quitting by displaying
  2489.         "Buffer(s) modified - quit (Y/N)? ". Enter Y to abort, N to cancel
  2490.         and resume editing.
  2491.  
  2492.         EXIT
  2493.  
  2494.         Terminates the editing session and returns you to DOS. The current
  2495.         buffer is automatically written to disk if it has been modified.
  2496.         If any of the other user buffers have been altered, pEDIT asks you
  2497.         one at a time if you want to write (save) them. Answer 'Y' to save
  2498.         the buffer, 'N' to skip it.
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.  
  2516.  
  2517.  
  2518.  
  2519.  
  2520.  
  2521.  
  2522.  
  2523.  
  2524.  
  2525.                                       - 40 -
  2526.  
  2527.  
  2528.  
  2529.                              M A C R O   F A C I L I T Y
  2530.  
  2531.                                     1. Macro Types
  2532.  
  2533.           pEDIT supports two different kinds of macros. The first is a key
  2534.         macro. The primary use of this type of macro (of which there can
  2535.         be only one) is to automate one-time tasks. If you find you are
  2536.         using the same stored keystrokes over and over, the macro should
  2537.         be given a name and saved to disk.
  2538.  
  2539.           The second type of macro is a disk macro. Start by setting up a
  2540.         key macro as above; experiment until you get it working the way
  2541.         you want. Then, issue the SAVE MACRO command and pick a file name.
  2542.         The name must be a standard DOS filename of up to 8 characters.
  2543.         Do not include a file type; pEDIT automatically adds the extension
  2544.         PM1. If the macro file already exists, you will be given a chance
  2545.         to overwrite the file or abort.
  2546.  
  2547.           Disk macros are used to automate things you do all of the time.
  2548.         Let's say you do medical transcription and constantly have to type
  2549.         in the phrase 'blood pressure'. Easy - define a disk macro 'BP' to
  2550.         automatically enter the text for you.
  2551.  
  2552.           Another use for disk macros is to extend the editor - to give it
  2553.         a capability it doesn't have. Two of the sample macros provide
  2554.         something that is not built-in to pEDIT: the ability to scroll the
  2555.         OTHER window up/down when the screen is split.
  2556.  
  2557.  
  2558.                                   2. Macro Execution
  2559.  
  2560.           A key macro is invoked by issuing the command EXECUTE without
  2561.         any parameters.
  2562.  
  2563.           Disk macros are executed via "EXECUTE filename" where filename
  2564.         is the name the macro was saved under. Again, do not specify a
  2565.         file type. pEDIT looks for the macro files in the directory
  2566.         pointed to by the PEDIT PATH.
  2567.  
  2568.  
  2569.                                    3. Sample Macros
  2570.  
  2571.           pEDIT is supplied with four sample macros which will be in-
  2572.         stalled under the following names. As usual, XXX refers to the
  2573.         configuration type (EMC, QUI, STD, WPF or WST):
  2574.  
  2575.             XXXLETTR.PM1       Sets the left margin to 10, the right
  2576.                                margin to 70 and the paragraph indent
  2577.                                to 4 for a letter with 1" margins
  2578.  
  2579.             XXXOTHUP.PM1       Scrolls the other window up
  2580.  
  2581.  
  2582.  
  2583.                                         - 41 -
  2584.  
  2585.  
  2586.             XXXOTHDN.PM1       Scrolls the other window down
  2587.  
  2588.             XXXWREV.PM1        Moves one word in the reverse direction;
  2589.                                temporarily changes the buffer direction
  2590.                                to Reverse - so you must start Forward
  2591.  
  2592.  
  2593.                               4. Converting Disk Macros
  2594.  
  2595.           pEDIT PLUS 1.1 uses a different disk macro file format than did
  2596.         earlier versions. The macros supplied with v1.1 are in the new
  2597.         format; any macros you have created will have to be converted. A
  2598.         conversion program PMCONVRT is included for this purpose.
  2599.  
  2600.           The program file PMCONVRT.EXE will be in the directory where you
  2601.         installed pEDIT. PMCONVRT will automatically convert all of the
  2602.         PMC files it finds in the current directory to the new PM1 format;
  2603.         the original files will be retained with the PMC extension.
  2604.  
  2605.           PMCONVRT assumes that <Ctrl-I> is <Tab>, <Ctrl-M> is <Enter>,
  2606.         <Ctrl-H> is <BackSpace> and <Ctrl-J> is <Ctrl-Enter>. There are
  2607.         some cases where PMCONVERT will not be able to convert an old file
  2608.         correctly and you will have to recreate it. If the DO COMMAND key
  2609.         has changed (this happened with the STD configuration) things
  2610.         obviously won't work right. Also, multi-key combination can't be
  2611.         translated because PMCONVRT can't know what shift keys are in use.
  2612.  
  2613.           If you installed pEDIT in the default \PEDIT directory you would
  2614.         run the the conversion program as follows:
  2615.  
  2616.               CD \PEDIT
  2617.               PMCONVRT
  2618.  
  2619.           PMCONVRT will convert up to 32 files in a single pass. If you
  2620.         have more than 32 macros, you will have to rename the first 32 to
  2621.         an extension other than PMC and run the program again. After you
  2622.         are confident that the conversion was successful, you can delete
  2623.         the files *.PMC and PMCONVRT.EXE.
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.                                         - 42 -
  2640.  
  2641.  
  2642.  
  2643.                             D E F I N I N G   K E Y S  I N
  2644.                                  p E D I T   P L U S
  2645.  
  2646.  
  2647.           Virtually any key (including any combination of Shift, Control
  2648.         and Alt keys) on the keyboard can now be defined thanks to pEDIT's
  2649.         new keyboard interrupt handler. pEDIT is able to do this by inter-
  2650.         cepting the key press (which would normally be processed by the
  2651.         BIOS) directly in hardware.
  2652.  
  2653.           The only keys that can't be defined are Tab, Enter and Space
  2654.         (typing keys), <BackSpace> and <Shift-Esc>. You can define ANY
  2655.         other key... including ones you shouldn't(!) After pEDIT has pro-
  2656.         cessed a key, it is passed on to the BIOS to be handled in the
  2657.         normal way. If this wasn't done, you couldn't reboot with the
  2658.         three fingered salute (Ctrl-Alt-Del) or print the screen (PrtScr).
  2659.  
  2660.           You should therefore not define any keys that have a special
  2661.         meaning to the system; your system manuals should have a list of
  2662.         these keys. Also, you wouldn't want to define any "hot" keys for
  2663.         TSRs such as screen blankers. Finally, it is recommended that you
  2664.         not define any of the keys which have a special mening to Micro-
  2665.         soft Windows: <Alt-Space>, <Alt-Tab>, <Alt-Enter>, <Alt-Esc>,
  2666.         <Ctrl-Esc>, etc.
  2667.  
  2668.           It should be noted that certain keys are not seen as identical
  2669.         as they would be under the BIOS. The following keys are no longer
  2670.         equivalent: <Ctrl-H> and <BackSpace>, <Ctrl-I> and <Tab>, <Ctrl-M>
  2671.         and <Enter>. This means that you can define <Ctrl-H>, <Ctrl-I> and
  2672.         <Ctrl-M> just like any other Control key.
  2673.  
  2674.           This new capability opens up many new possibilites. pEDIT can
  2675.         now emulate any editor or word processor that uses 2-key commands.
  2676.         And, this is what lets the STD configuration be CUA-compliant. Un-
  2677.         fortunately, WordPerfect uses 3- and 4-key combinations, and so
  2678.         the emulation is approximate.
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.  
  2685.  
  2686.  
  2687.  
  2688.  
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.  
  2695.  
  2696.                                         - 43 -
  2697.  
  2698.  
  2699.  
  2700.                          E X T E N D E D   D O S   S H E L L
  2701.  
  2702.  
  2703.           pEDIT has an intelligent DOS shell which provides up to 350k of
  2704.         free memory on a 640k machine when shelled to DOS. This provides
  2705.         sufficient free memory to complile from within pEDIT and to run
  2706.         large programs.
  2707.  
  2708.           All text is temporarily 'swapped' out to disk and the memory is
  2709.         released before calling DOS. When the user types 'EXIT' to return
  2710.         to the parent program, the text storage is reallocated and re-
  2711.         loaded from these swap files.
  2712.  
  2713.           pEDIT checks to make sure there is sufficient disk space to hold
  2714.         the swap files. If not, the function will be cancelled. It is very
  2715.         important that you not delete the temporary swap files, which are
  2716.         stored in the PEDIT PATH with names of PED$$$n.TMP where n = 0-4.
  2717.         Note that pEDIT automatically deletes these files after they have
  2718.         been reloaded into memory.
  2719.  
  2720.           DO NOT run any TSR (Terminate and Stay Resident) programs when
  2721.         shelled to DOS. This is a sure way to lock up your computer. Some
  2722.         examples of TSRs are the DOS PRINT utility and mouse drivers such
  2723.         as MOUSE.COM.
  2724.  
  2725.  
  2726.  
  2727.  
  2728.  
  2729.  
  2730.  
  2731.  
  2732.  
  2733.  
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.  
  2752.  
  2753.                                         - 44 -
  2754.  
  2755.  
  2756.  
  2757.                                D R A W I N G   W I T H
  2758.                                  p E D I T   P L U S
  2759.  
  2760.  
  2761.           pEDIT PLUS now supports automatic line and box drawing in 3
  2762.         different styles. These figures can be drawn using graphical
  2763.         single lines, graphical double lines or ordinary text characters:
  2764.  
  2765.               ┌───────┐            ╔═══════╗            +-------+
  2766.               │       │            ║       ║            |       |
  2767.               └───────┘            ╚═══════╝            +-------+
  2768.                  (-)                  (=)                  (+)
  2769.  
  2770.           Follow these three simple steps to draw:
  2771.  
  2772.           1. Issue the DRAW command or click on the <DRW> Button to enter
  2773.              drawing mode; the starting cursor position (the anchor) will
  2774.              remain highlighted in reverse video. The Status Bar will show
  2775.              "** DRAWING MODE **" until you finish or abort.
  2776.  
  2777.           2. Use the MOVE UP, MOVE DOWN, MOVE LEFT, MOVE RIGHT, MOVE HOME
  2778.              and MOVE END keys (the mouse can't be used here) to move to
  2779.              the opposite end of the line or box. You can move in any
  2780.              direction. If you move past the end of a line, the line will
  2781.              be padded with spaces to extend it to the desired offset.
  2782.  
  2783.           3. Press one of the three style keys dash (-), equals (=) or
  2784.              plus (+) shown above to select the desired style and complete
  2785.              the drawing. You can abort without drawing anything by pres-
  2786.              sing the ABORT key.
  2787.  
  2788.           Your printer may not be able to print the graphical single and
  2789.         double lines because they use the special graphical characters
  2790.         above decimal 127. However, any printer can print the plain text
  2791.         style (+-----+).
  2792.  
  2793.           If you use the auto padding as described above, there is one
  2794.         thing to be aware of. As you move to the right, the cursor will be
  2795.         on the imaginary end of line, not on the last character of the
  2796.         line. You must therefore move one column *past* where you want the
  2797.         line or box to be drawn; on the ending line, move back in one col-
  2798.         umn so the cursor is on the last character of the line. Note also
  2799.         that the figures won't de drawn correctly if the text contains any
  2800.         tabs.
  2801.  
  2802.  
  2803.  
  2804.  
  2805.  
  2806.  
  2807.  
  2808.  
  2809.  
  2810.                                         - 45 -
  2811.  
  2812.  
  2813.  
  2814.                               P R I N T I N G   F R O M
  2815.                                  p E D I T   P L U S
  2816.  
  2817.  
  2818.           Registered pEDIT PLUS owners can now print directly from the
  2819.         program. If you are evaluating a shareware version of pEDIT, you
  2820.         will be informed that the PRINT function is only available in the
  2821.         registered version. If you need a reason to register, here it is.
  2822.  
  2823.           pEDIT PLUS is not a $500 word processor and cannot compete with
  2824.         programs like WordPerfect which must provide printer drivers for
  2825.         hundreds of printers. This would add immeasurably to the size and
  2826.         complexity of pEDIT. pEDIT supports printing by interfacing to the
  2827.         DOS PRINT utility, which is included with DOS 3.0 and later.
  2828.  
  2829.           The PRINT program is a TSR which performs "background" printing;
  2830.         that is, it can print while you do other things. A maximum of 32
  2831.         files can be queued; the default is 10 files. pEDIT will let you
  2832.         print one (or more) files while you continue to work. Printing
  2833.         will continue even if you shell to DOS or exit.
  2834.  
  2835.           In order for pEDIT to print correctly, you must install the DOS
  2836.         PRINT utility *before* you execute pEDIT. The easiest way to do
  2837.         this is to install PRINT in your AUTOEXEC.BAT file at startup:
  2838.  
  2839.             PRINT /D:LPT1
  2840.  
  2841.           This example loads the PRINT program into memory and tells it to
  2842.         use the first parallel printer LPT1. Valid devices are LPTn, COMn
  2843.         and PRN, which is the same as LPT1. Refer to your DOS manuals for
  2844.         more information.
  2845.  
  2846.           Once PRINT has been installed, you can perform the following
  2847.         functions from within pEDIT PLUS:
  2848.  
  2849.           1. PRINT BUFFER; print the current buffer
  2850.  
  2851.           2. PRINT BLOCK; print a selected block of text
  2852.  
  2853.           3. PRINT DELETE; delete a file from the queue
  2854.  
  2855.           4. PRINT CANCEL; cancel all print jobs in the queue
  2856.  
  2857.           5. SHOW PRINTER; examine the print queue.
  2858.  
  2859.         Important: option (1) will print the file associated with the
  2860.         current buffer; you will therefore be asked if you want to save a
  2861.         modified buffer before printing.
  2862.  
  2863.           When printing a block, you must select full lines as explained
  2864.         for the INDENT command. pEDIT writes the selected block into the
  2865.  
  2866.  
  2867.                                         - 46 -
  2868.  
  2869.  
  2870.  
  2871.         file PED$$.PRN, which is then printed.
  2872.  
  2873.           pEDIT currently does not have a repaginate command to insert
  2874.         form feeds into a document. Note, however, that you can repaginate
  2875.         by defining a macro which moves down the number of lines you want
  2876.         per page, and then inserts a form feed (Ascii ^L, decimal 12).
  2877.  
  2878.  
  2879.  
  2880.  
  2881.  
  2882.  
  2883.  
  2884.  
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.  
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.  
  2909.  
  2910.  
  2911.  
  2912.  
  2913.  
  2914.  
  2915.  
  2916.  
  2917.  
  2918.  
  2919.  
  2920.  
  2921.  
  2922.  
  2923.  
  2924.                                         - 47 -
  2925.  
  2926.  
  2927.  
  2928.                            C O M P I L I N G   F R O M
  2929.                                p E D I T   P L U S
  2930.  
  2931.  
  2932.           Programs can be compiled from within pEDIT using the built-in
  2933.         DOS function. There are several ways to accomplish this; in all
  2934.         cases, the output will be placed in the DOS buffer so you can see
  2935.         any errors.
  2936.  
  2937.  
  2938.                                  1. Manual Invocation
  2939.  
  2940.           The simplest method is to issue the command(s) from within the
  2941.         editor. Unfortunately, a different command line must be typed in
  2942.         for every source buffer so this can't be easily automated. pEDIT
  2943.         supports simple command substitution to translate
  2944.  
  2945.              DOS \QBASIC\BC % /S /O ;
  2946.  
  2947.         to, for example,
  2948.  
  2949.              DOS \QBASIC\BC C:\BASIC\TEST /S /O ;
  2950.  
  2951.         pEDIT will substitute the file name associated with the current
  2952.         buffer less the file type. The file type (extension) is not in-
  2953.         cluded because compilers and linkers typically use the same file
  2954.         name but a different file type.
  2955.  
  2956.  
  2957.                                     2. Batch File
  2958.  
  2959.           Another method is to use a DOS batch (BAT) file to perform the
  2960.         compilation. This method requires some finagling because there is
  2961.         no way to direct all of the the output from a BAT file. Recall
  2962.         that pEDIT uses a temporary file (PED$$.TMP) to capture the output
  2963.         from a shelled DOS command.
  2964.  
  2965.           The trick is to redirect the output from your batch file to
  2966.         PED$$.TMP. Simply add the text ">>PED$$.TMP" to the end of every
  2967.         line in your batch file that displays output. This tells DOS to
  2968.         direct the output to PED$$.TMP and to append to the file.
  2969.  
  2970.  
  2971.                                     3. Disk Macros
  2972.  
  2973.           The most elegant way to compile is with pEDIT's disk macros. The
  2974.         macros can even automatically step through the compile errors and
  2975.         position to each offending line in the source file! This is quite
  2976.         impressive considering that no macro language is used.
  2977.  
  2978.           Only the general method, which requires two macros, can be out-
  2979.  
  2980.  
  2981.                                         - 48 -
  2982.  
  2983.  
  2984.  
  2985.         lined here. The first does the actual compilation and positions
  2986.         the DOS buffer to the start of the latest compile statement. The
  2987.         second steps through the errors one-at-a-time by moving to the DOS
  2988.         window, finding an error string and storing it on the clipboard,
  2989.         and returning to the source window and using FIND to position to
  2990.         the offending line.
  2991.  
  2992.           The most difficult part of the second macro is locating the
  2993.         errors! Compilers use different error indicators. A caret (^) on
  2994.         one line is fairly common to point to the offending part of a
  2995.         statement on the line above. Another problem is that a single
  2996.         source line can generate several errors.
  2997.  
  2998.  
  2999.  
  3000.  
  3001.  
  3002.  
  3003.  
  3004.  
  3005.  
  3006.  
  3007.  
  3008.  
  3009.  
  3010.  
  3011.  
  3012.  
  3013.  
  3014.  
  3015.  
  3016.  
  3017.  
  3018.  
  3019.  
  3020.  
  3021.  
  3022.  
  3023.  
  3024.  
  3025.  
  3026.  
  3027.  
  3028.  
  3029.  
  3030.  
  3031.  
  3032.  
  3033.  
  3034.  
  3035.  
  3036.  
  3037.  
  3038.                                         - 49 -
  3039.  
  3040.  
  3041.  
  3042.                              E R R O R   H A N D L I N G
  3043.  
  3044.           If an error occurs, pEDIT will bring up an ERROR window and
  3045.         alert you to one of the following problems.
  3046.  
  3047.  
  3048.                            1. Insufficient Internal Storage
  3049.  
  3050.           When it is invoked, pEDIT checks to see how much free memory is
  3051.         available. This determines the maximum number of lines and char-
  3052.         acters of text it can handle. pEDIT informs you whenever 99% of
  3053.         either of these values is reached and advises you to "Save your
  3054.         work and exit". If you continue to work, you will get the warning
  3055.         *every* time text is added. If you ignore the warnings and exceed
  3056.         the allocated space, the program will abort.
  3057.  
  3058.           There is no recovery from this other than to exit (be sure and
  3059.         save your work) and start over. pEDIT presently cannot free up
  3060.         memory once it has been allocated.
  3061.  
  3062.  
  3063.                               2. Insufficient Disk Space
  3064.  
  3065.           pEDIT checks for sufficient disk space BEFORE it starts a file
  3066.         save operation. If there isn't enough disk space, you will be
  3067.         advised to "Increase available space on current drive or change
  3068.         file specification via RENAME FILE".
  3069.  
  3070.           The text is still in memory and has not been lost; however, it
  3071.         has *not* been saved to disk. If possible, shell to DOS and delete
  3072.         some files to free up space. Or, switch to a different diskette
  3073.         that has more room. Or, use the RENAME FILE command to change to
  3074.         another drive; for example, if the current file is A:MYFILE.TXT,
  3075.         save the file as B:MYFILE.TXT.
  3076.  
  3077.  
  3078.                               3. No Initialization File
  3079.  
  3080.           pEDIT requires an initilization file for proper operation. The
  3081.         default init file is named PEDIT.INI. If this file cannot be
  3082.         found, it means that pEDIT has not been properly installed using
  3083.         the INSTALL program.
  3084.  
  3085.           If an initialization file can't be found, pEDIT will start up
  3086.         with a minimal configuration so you can communicate with the
  3087.         editor. The colors are set to white on blue, and the labelled keys
  3088.         such as the cursor keys, <Ins>, <Del>, <PgUp> and <PgDn> are bound
  3089.         to their expected functions. Finally, the <Esc> key is defined as
  3090.         DO COMMAND.
  3091.  
  3092.  
  3093.  
  3094.  
  3095.                                         - 50 -
  3096.  
  3097.  
  3098.  
  3099.                               M I S C E L L A N E O U S
  3100.                                  L E G A L I T I E S
  3101.  
  3102.  
  3103.                                  1. Copyright Notice
  3104.  
  3105.           This document, other accompanying written and disk-based
  3106.         specifications, and all referenced and related program files are
  3107.         copyrighted by T. G. Muench.
  3108.  
  3109.           PC-DOS is a registered trademark of International Business
  3110.         Machines Corporation. MS-DOS and QuickBASIC are trademarks of
  3111.         Microsoft Corporation. WordPerfect is a trademark of Word Perfect
  3112.         Corporation. WordStar is a registered trademark of MicroPro
  3113.         International. Other brand and product names are trademarks or
  3114.         registered trademarks of their respective holders.
  3115.  
  3116.  
  3117.                                    2. Registration
  3118.  
  3119.           pEDIT PLUS is a "shareware program" and is provided at no charge
  3120.         to the user for evaluation. Feel free to share it with your
  3121.         friends, but please do not give it away altered or as part of
  3122.         another system. The essence of "user-supported" software is to
  3123.         provide personal computer users with quality software without high
  3124.         prices, and yet to provide incentive for programmers to continue
  3125.         to develop new products. If you find this program useful and find
  3126.         that you are using pEDIT PLUS and continue to use pEDIT PLUS after
  3127.         a reasonable trial period, you must make a registration payment to
  3128.         T. G. Muench.
  3129.  
  3130.           Print the file REGISTER.DOC for complete information on how to
  3131.         register for pEDIT PLUS and how to contact the author.
  3132.  
  3133.  
  3134.  
  3135.  
  3136.  
  3137.  
  3138.  
  3139.  
  3140.  
  3141.  
  3142.  
  3143.  
  3144.  
  3145.  
  3146.  
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.                                         - 51 -
  3153.  
  3154.  
  3155.  
  3156.                                A P P E N D I C E S
  3157.  
  3158.                                  A. Key Bindings
  3159.  
  3160.                                 1. Labelled Keys
  3161.  
  3162.         Many of the labeled keys on the PC keyboard are bound to functions
  3163.         common to all configurations. The function bound to these keys
  3164.         corresponds to the key name. Keys marked with (*) cannot be re-
  3165.         defined.
  3166.  
  3167.  
  3168.             (*)BackSpace           ERASE PREV
  3169.             (*)Tab                 INSERT CHAR
  3170.             (*)Enter               INSERT CHAR
  3171.             (*)Space               INSERT CHAR
  3172.  
  3173.                Home                MOVE HOME
  3174.                End                 MOVE END
  3175.                Del                 ERASE CHAR
  3176.                PgUp                PREV SCREEN
  3177.                PgDn                NEXT SCREEN
  3178.                Up                  MOVE UP
  3179.                Down                MOVE DOWN
  3180.                Left                MOVE LEFT
  3181.                Right               MOVE RIGHT
  3182.  
  3183.                Ctrl-Enter          AUTO INDENT
  3184.  
  3185.  
  3186.  
  3187.  
  3188.  
  3189.  
  3190.  
  3191.  
  3192.  
  3193.  
  3194.  
  3195.  
  3196.  
  3197.  
  3198.  
  3199.  
  3200.  
  3201.  
  3202.  
  3203.  
  3204.  
  3205.  
  3206.  
  3207.  
  3208.  
  3209.                                         - 52 -
  3210.  
  3211.  
  3212.  
  3213.                                  A P P E N D I C E S
  3214.  
  3215.                                    A. Key Bindings
  3216.  
  3217.                                    2. Standard/CUA
  3218.  
  3219.  
  3220.                F10                 DO COMMAND
  3221.  
  3222.                F01                 ALTHELP
  3223.                F02                 BUFFER
  3224.                F03                 FINDNEXT
  3225.                F06                 CHANGE DIR
  3226.                F07                 LEARN
  3227.                F08                 REPEAT
  3228.  
  3229.                Shift-F01           HELP
  3230.                Shift-F03           FIND
  3231.                Ctrl-F06            OTHER WINDOW
  3232.                Alt-F03             REPLACE
  3233.                Alt-F04             EXIT
  3234.  
  3235.                Up                  MOVE UP
  3236.                Down                MOVE DOWN
  3237.                Left                MOVE LEFT
  3238.                Right               MOVE RIGHT
  3239.                Home                MOVE HOME
  3240.                End                 MOVE END
  3241.                Ctrl-Home           MOVE TOP
  3242.                Ctrl-End            MOVE BOTTOM
  3243.                Ctrl-Right          MOVE WORD
  3244.                Ctrl-Left           EXECUTE STDWREV
  3245.                Ctrl-Up             PREV LINE
  3246.                PgUp                PREV SCREEN
  3247.                Ctrl-Down           NEXT LINE
  3248.                PgDn                NEXT SCREEN
  3249.                Shift-Ctrl-Left     SHIFT LEFT
  3250.                Shift-Ctrl-Right    SHIFT RIGHT
  3251.                Ctrl-PgUp           EXECUTE STDOTHUP
  3252.                Ctrl-PgDn           EXECUTE STDOTHDN
  3253.  
  3254.                Del                 ERASE CHAR
  3255.                Ctrl-Backspace      ERASE WORD
  3256.                Ctrl-Y              ERASE LINE
  3257.                Shift-Ctrl-Y        ERASE LINE
  3258.                Alt-Backspace       RESTORE TEXT
  3259.  
  3260.                Shift-Del           REMOVE TEXT
  3261.                Ctrl-Del            WIPE TEXT
  3262.                Ctrl-Ins            STORE TEXT
  3263.                Shift-Ins           INSERT HERE
  3264.  
  3265.  
  3266.                                         - 53 -
  3267.  
  3268.  
  3269.  
  3270.                Shift-Ctrl-I        INDENT 1
  3271.                Shift-Ctrl-U        INDENT -1
  3272.                Ctrl-0              GOTO MARK
  3273.                Ctrl-B              RECALL
  3274.                Ctrl-O              OPEN LINE
  3275.                Ctrl-V              QUOTE CHAR
  3276.                Ctrl-R              REMEMBER
  3277.                Ctrl-W              REFRESH SCREEN
  3278.  
  3279.                Alt-1               ONE WINDOW
  3280.                Alt-2               TWO WINDOWS
  3281.                Alt-A               LIST ASCII
  3282.                Alt-C               CAPITAL WORD
  3283.                Alt-D               DRAW
  3284.                Alt-F               FILL PARA
  3285.                Alt-G               GET FILE
  3286.                Alt-I               INCLUDE FILE
  3287.                Alt-J               JUSTIFY PARA
  3288.                Alt-K               DEFINE KEY
  3289.                Alt-L               LOWER WORD
  3290.                Alt-M               SET MARGINS
  3291.                Alt-N               RENAME FILE
  3292.                Alt-P               SET PINDENT
  3293.                Alt-Q               QUIT
  3294.                Alt-R               RULER
  3295.                Alt-S               SELECT TEXT
  3296.                Alt-T               TRANS CHAR
  3297.                Alt-U               UPPER WORD
  3298.                Alt-V               SET VIDEO
  3299.                Alt-W               WRITE FILE
  3300.  
  3301.                Esc                 ABORT
  3302.                Ctrl-Enter          AUTO INDENT
  3303.                Ins                 CHANGE MODE
  3304.                Shift-Ctrl-0        MARK
  3305.                Alt-Left            LEFT LINE
  3306.                Alt-Center          CENTER LINE
  3307.                Alt-Right           RIGHT LINE
  3308.                Shift-Ctrl-P        PRINT BUFFER
  3309.                Shift-Ctrl-Q        SHOW PRINTER
  3310.                Shift-Ctrl-G        SET SCOPE GLOBAL
  3311.                Shift-Ctrl-L        SET SCOPE LOCAL
  3312.  
  3313.  
  3314.  
  3315.  
  3316.  
  3317.  
  3318.  
  3319.  
  3320.  
  3321.  
  3322.  
  3323.                                         - 54 -
  3324.  
  3325.  
  3326.  
  3327.                                  A P P E N D I C E S
  3328.  
  3329.                                    A. Key Bindings
  3330.  
  3331.                                      3. WordStar
  3332.  
  3333.  
  3334.                Esc                 DO COMMAND
  3335.  
  3336.                F01                 HELP
  3337.                F03                 FINDNEXT
  3338.                F05                 CHANGE MODE
  3339.                F06                 CHANGE DIR
  3340.                F07                 LEARN
  3341.                F08                 REPEAT
  3342.                F11                 STORE TEXT
  3343.  
  3344.                Ctrl-A              EXECUTE WSTWREV
  3345.                Ctrl-B              FILL PARA
  3346.                Ctrl-C              NEXT SCREEN
  3347.                Ctrl-D              MOVE RIGHT
  3348.                Ctrl-E              MOVE UP
  3349.                Ctrl-F              MOVE WORD
  3350.                Ctrl-G              ERASE CHAR
  3351.                Ctrl-L              FINDNEXT
  3352.                Ctrl-N              OPEN LINE
  3353.                Ctrl-P              QUOTE CHAR
  3354.                Ctrl-R              PREV SCREEN
  3355.                Ctrl-S              MOVE LEFT
  3356.                Ctrl-T              ERASE WORD
  3357.                Ctrl-U              RESTORE TEXT
  3358.                Ctrl-V              CHANGE MODE
  3359.                Ctrl-W              PREV LINE
  3360.                Ctrl-X              MOVE DOWN
  3361.                Ctrl-Y              ERASE LINE
  3362.                Ctrl-Z              NEXT LINE
  3363.  
  3364.                Ctrl-K+B            SELECT TEXT
  3365.                Ctrl-K+C            INSERT HERE
  3366.                Ctrl-K+D            GET FILE
  3367.                Ctrl-K+F            RENAME FILE
  3368.                Ctrl-K+P            PRINT BLOCK
  3369.                Ctrl-K+Q            QUIT
  3370.                Ctrl-K+R            INCLUDE FILE
  3371.                Ctrl-K+S            WRITE FILE
  3372.                Ctrl-K+U            SELECT TEXT
  3373.                Ctrl-K+Y            REMOVE TEXT
  3374.                Ctrl-K+X            EXIT
  3375.  
  3376.                Ctrl-Q+A            REPLACE
  3377.                Ctrl-Q+C            MOVE BOTTOM
  3378.  
  3379.  
  3380.                                         - 55 -
  3381.  
  3382.  
  3383.  
  3384.                Ctrl-Q+D            MOVE END
  3385.                Ctrl-Q+F            FIND
  3386.                Ctrl-Q+I            LINE
  3387.                Ctrl-Q+P            GOTO MARK
  3388.                Ctrl-Q+R            MOVE TOP
  3389.                Ctrl-Q+S            MOVE HOME
  3390.                Ctrl-Q+Y            ERASE LINE
  3391.  
  3392.                Ctrl-O+C            CENTER LINE
  3393.                Ctrl-O+L            SET MARGINS
  3394.                Ctrl-O+R            SET MARGINS
  3395.  
  3396.                Ctrl-Enter          AUTO INDENT
  3397.  
  3398.                Alt-A               LIST ASCII
  3399.                Alt-B               BUFFER
  3400.                Alt-C               CAPITAL WORD
  3401.                Alt-D               DRAW
  3402.                Alt-H               ALTHELP
  3403.                Alt-J               JUSTIFY PARA
  3404.                Alt-K               DEFINE KEY
  3405.                Alt-L               LOWER WORD
  3406.                Alt-O               OTHER WINDOW
  3407.                Alt-P               SET PINDENT
  3408.                Alt-Q               QUIT
  3409.                Alt-R               REMEMBER
  3410.                Alt-S               SET SCOPE
  3411.                Alt-T               TRANS CHAR
  3412.                Alt-U               UPPER WORD
  3413.                Alt-V               SET VIDEO
  3414.                Alt-X               ABORT
  3415.                Alt-1               ONE WINDOW
  3416.                Alt-2               TWO WINDOWS
  3417.  
  3418.                Home                MOVE HOME
  3419.                End                 MOVE END
  3420.                Up                  MOVE UP
  3421.                Down                MOVE DOWN
  3422.                Left                MOVE LEFT
  3423.                Right               MOVE RIGHT
  3424.                PgUp                PREV SCREEN
  3425.                PgDn                NEXT SCREEN
  3426.                Ins                 CHANGE MODE
  3427.                Del                 ERASE CHAR
  3428.                Ctrl-Left           SHIFT LEFT
  3429.                Ctrl-Right          SHIFT RIGHT
  3430.                Ctrl-PgUp           EXECUTE WSTOTHUP
  3431.                Ctrl-PgDn           EXECUTE WSTOTHDN
  3432.  
  3433.  
  3434.  
  3435.  
  3436.  
  3437.                                         - 56 -
  3438.  
  3439.  
  3440.  
  3441.                                  A P P E N D I C E S
  3442.  
  3443.                                    A. Key Bindings
  3444.  
  3445.                                    4. Word Perfect
  3446.  
  3447.  
  3448.                Esc                 DO COMMAND
  3449.  
  3450.                F01                 ABORT
  3451.                F02                 FIND
  3452.                F03                 ALTHELP
  3453.                F04                 INDENT 1
  3454.                F05                 GET FILE
  3455.                F07                 QUIT
  3456.                F10                 WRITE FILE
  3457.  
  3458.                Shift-F02           FINDNEXT
  3459.                Shift-F03           OTHER WINDOW
  3460.                Shift-F04           INDENT -1
  3461.                Shift-F06           CENTER LINE
  3462.                Shift-F08           SET MARGINS
  3463.                Shift-F10           INCLUDE FILE
  3464.  
  3465.                Ctrl-F01            DOS
  3466.                Ctrl-F10            LEARN
  3467.  
  3468.                Alt-F02             REPLACE
  3469.                Alt-F04             SELECT TEXT
  3470.                Alt-F06             RIGHT LINE
  3471.                Alt-F09             DRAW
  3472.                Alt-F10             EXECUTE
  3473.  
  3474.                Ctrl-Home           LINE
  3475.                Ctrl-Left           EXECUTE WPFWREV
  3476.                Ctrl-Right          MOVE WORD
  3477.                Home+Left           SHIFT LEFT
  3478.                Home+Right          SHIFT RIGHT
  3479.                Home+Up             MOVE TOP
  3480.                Home+Down           MOVE BOTTOM
  3481.                Home+Home           MOVE HOME
  3482.                End                 MOVE END
  3483.                Home+End            MOVE END
  3484.  
  3485.                Ctrl-F03+C          SET COLOR
  3486.                Ctrl-F03+K          DEFINE KEY
  3487.                Ctrl-F03+R          RULER
  3488.                Ctrl-F03+1          ONE WINDOW
  3489.                Ctrl-F03+2          TWO WINDOWS
  3490.  
  3491.                Ctrl-F04+1          REMOVE TEXT
  3492.  
  3493.  
  3494.                                         - 57 -
  3495.  
  3496.  
  3497.  
  3498.                Ctrl-F04+2          STORE TEXT
  3499.                Ctrl-F04+Del        WIPE TEXT
  3500.                Ctrl-F04+R          INSERT HERE
  3501.  
  3502.                Shift-F07+P         PRINT BUFFER
  3503.                Shift-F07+B         PRINT BLOCK
  3504.                Shift-F07+D         PRINT DELETE
  3505.                Shift-F07+C         PRINT CANCEL
  3506.                Shift-F07+S         SHOW PRINTER
  3507.  
  3508.                Del                 ERASE CHAR
  3509.                Ctrl-Backspace      ERASE WORD
  3510.                Ctrl-End            ERASE LINE
  3511.                Alt-Backspace       RESTORE TEXT
  3512.  
  3513.                Ctrl-Enter          AUTO INDENT
  3514.                Ctrl-R              REMEMBER
  3515.  
  3516.                Up                  MOVE UP
  3517.                Down                MOVE DOWN
  3518.                Left                MOVE LEFT
  3519.                Right               MOVE RIGHT
  3520.                PgUp                PREV SCREEN
  3521.                PgDn                NEXT SCREEN
  3522.                Ins                 CHANGE MODE
  3523.                Ctrl-PgUp           EXECUTE WPFOTHUP
  3524.                Ctrl-PgDn           EXECUTE WPFOTHDN
  3525.  
  3526.                Alt-A               LIST ASCII
  3527.                Alt-B               BUFFER
  3528.                Alt-C               CAPITAL WORD
  3529.                Alt-D               CHANGE DIR
  3530.                Alt-F               FILL PARA
  3531.                Alt-H               HELP
  3532.                Alt-J               JUSTIFY PARA
  3533.                Alt-K               QUOTE CHAR
  3534.                Alt-L               LOWER WORD
  3535.                Alt-P               SET PINDENT
  3536.                Alt-Q               QUIT
  3537.                Alt-R               REPEAT
  3538.                Alt-S               SET SCOPE
  3539.                Alt-T               TRANS CHAR
  3540.                Alt-U               UPPER WORD
  3541.                Alt-V               SET VIDEO
  3542.                Alt-X               EXIT
  3543.  
  3544.  
  3545.  
  3546.  
  3547.  
  3548.  
  3549.  
  3550.  
  3551.                                         - 58 -
  3552.  
  3553.  
  3554.  
  3555.                                  A P P E N D I C E S
  3556.  
  3557.                                    A. Key Bindings
  3558.  
  3559.                                   5. Microsoft Quick
  3560.  
  3561.                Esc                 DO COMMAND
  3562.  
  3563.                F01                 HELP
  3564.                F02                 BUFFER
  3565.                F03                 FINDNEXT
  3566.                F05                 CHANGE MODE
  3567.                F06                 CHANGE DIR
  3568.                F07                 LEARN
  3569.                F08                 REPEAT
  3570.  
  3571.                Alt-F+O             GET FILE (Open)
  3572.                Alt-F+M             INCLUDE FILE (Merge)
  3573.                Alt-F+S             WRITE FILE (Save)
  3574.                Alt-F+A             RENAME FILE (save As)
  3575.                Alt-F+P             PRINT BUFFER (Print)
  3576.                Alt-F+D             DOS
  3577.                Alt-F+X             EXIT (eXit)
  3578.  
  3579.                Alt-E+S             SELECT TEXT
  3580.                Alt-E+T             REMOVE TEXT (cuT)
  3581.                Alt-E+C             STORE TEXT (Copy)
  3582.                Alt-E+P             INSERT HERE (Paste)
  3583.                Alt-E+E             WIPE TEXT (Erase)
  3584.                Alt-S+F             FIND (Find)
  3585.                Alt-S+R             FINDNEXT (Repeat find)
  3586.                Alt-S+C             REPLACE (Change)
  3587.  
  3588.                Ctrl-C              ABORT
  3589.                Ctrl-L              FINDNEXT
  3590.                Ctrl-P              QUOTE CHAR
  3591.                Ctrl-T              ERASE WORD
  3592.                Ctrl-U              RESTORE TEXT
  3593.                Ctrl-V              CHANGE MODE
  3594.                Ctrl-Y              ERASE LINE
  3595.                Ctrl-B              RECALL
  3596.                Ctrl-O              OPEN LINE
  3597.                Ctrl-R              REMEMBER
  3598.                Ctrl-W              PREV LINE
  3599.                Ctrl-Z              NEXT LINE
  3600.  
  3601.                Ctrl-Enter          AUTO INDENT
  3602.  
  3603.                Alt-1               ONE WINDOW
  3604.                Alt-2               TWO WINDOWS
  3605.                Alt-A               LIST ASCII
  3606.  
  3607.  
  3608.                                         - 59 -
  3609.  
  3610.  
  3611.  
  3612.                Alt-C               CAPITAL WORD
  3613.                Alt-D               DRAW
  3614.                Alt-H               ALTHELP
  3615.                Alt-F               FILL PARA
  3616.                Alt-J               JUSTIFY PARA
  3617.                Alt-K               DEFINE KEY
  3618.                Alt-L               LOWER WORD
  3619.                Alt-M               SET MARGINS
  3620.                Alt-O               OTHER WINDOW
  3621.                Alt-P               SET PINDENT
  3622.                Alt-Q               QUIT
  3623.                Alt-T               TRANS CHAR
  3624.                Alt-U               UPPER WORD
  3625.                Alt-V               SET VIDEO
  3626.                Alt-X               EXECUTE
  3627.  
  3628.                Home                MOVE HOME
  3629.                End                 MOVE END
  3630.                Up                  MOVE UP
  3631.                Down                MOVE DOWN
  3632.                Left                MOVE LEFT
  3633.                Right               MOVE RIGHT
  3634.                PgUp                PREV SCREEN
  3635.                PgDn                NEXT SCREEN
  3636.                Ins                 CHANGE MODE
  3637.                Del                 ERASE CHAR
  3638.                Ctrl-Left           EXECUTE QUIWREV
  3639.                Ctrl-Right          MOVE WORD
  3640.                Ctrl-Home           MOVE TOP
  3641.                Ctrl-End            MOVE BOTTOM
  3642.                Shift-Ctrl-Left     SHIFT LEFT
  3643.                Shift-Ctrl-Right    SHIFT RIGHT
  3644.                Ctrl-PgUp           EXECUTE QUIOTHUP
  3645.                Ctrl-PgDn           EXECUTE QUIOTHDN
  3646.  
  3647.  
  3648.  
  3649.  
  3650.  
  3651.  
  3652.  
  3653.  
  3654.  
  3655.  
  3656.  
  3657.  
  3658.  
  3659.  
  3660.  
  3661.  
  3662.  
  3663.  
  3664.  
  3665.                                         - 60 -
  3666.  
  3667.  
  3668.  
  3669.                                  A P P E N D I C E S
  3670.  
  3671.                                    A. Key Bindings
  3672.  
  3673.                                        6. Emacs
  3674.  
  3675.  
  3676.                Esc+Esc             DO COMMAND
  3677.  
  3678.                F01                 HELP
  3679.                F03                 FINDNEXT
  3680.                F05                 CHANGE MODE
  3681.                F06                 CHANGE DIR
  3682.                F09                 RESTORE TEXT
  3683.                F11                 STORE TEXT
  3684.  
  3685.                Ctrl-A              MOVE HOME
  3686.                Ctrl-B              MOVE LEFT
  3687.                Ctrl-C              DOS
  3688.                Ctrl-D              ERASE CHAR
  3689.                Ctrl-E              MOVE END
  3690.                Ctrl-F              MOVE RIGHT
  3691.                Ctrl-G              ABORT
  3692.                Ctrl-K              ERASE LINE
  3693.                Ctrl-L              REFRESH SCREEN
  3694.                Ctrl-N              MOVE DOWN
  3695.                Ctrl-P              MOVE UP
  3696.                Ctrl-S              FIND
  3697.                Ctrl-T              TRANS CHAR
  3698.                Ctrl-U              REPEAT
  3699.                Ctrl-V              NEXT SCREEN
  3700.                Ctrl-W              REMOVE TEXT
  3701.                Ctrl-Y              INSERT HERE
  3702.                Ctrl-Z              EXIT
  3703.  
  3704.                Ctrl-X+(            LEARN
  3705.                Ctrl-X+)            REMEMBER
  3706.                Ctrl-X+1            ONE WINDOW
  3707.                Ctrl-X+2            TWO WINDOWS
  3708.                Ctrl-X+B            BUFFER
  3709.                Ctrl-X+E            EXECUTE
  3710.                Ctrl-X+N            OTHER WINDOW
  3711.                Ctrl-X+P            OTHER WINDOW
  3712.                Ctrl-X+Ctrl-C       QUIT
  3713.                Ctrl-X+Ctrl-F       RENAME FILE
  3714.                Ctrl-X+Ctrl-P       PRINT BLOCK
  3715.                Ctrl-X+Ctrl-R       INCLUDE FILE
  3716.                Ctrl-X+Ctrl-S       WRITE FILE
  3717.                Ctrl-X+Ctrl-V       GET FILE
  3718.  
  3719.                Esc+.               SELECT TEXT
  3720.  
  3721.  
  3722.                                         - 61 -
  3723.  
  3724.  
  3725.  
  3726.                Esc+<               MOVE TOP
  3727.                Esc+>               MOVE BOTTOM
  3728.                Esc+B               EXECUTE EMCWREV
  3729.                Esc+C               CAPITAL WORD
  3730.                Esc+D               ERASE WORD
  3731.                Esc+F               MOVE WORD
  3732.                Esc+L               LOWER WORD
  3733.                Esc+U               UPPER WORD
  3734.                Esc+V               PREV SCREEN
  3735.  
  3736.                Ctrl-Enter          AUTO INDENT
  3737.  
  3738.                Alt-A               LIST ASCII
  3739.                Alt-D               DRAW
  3740.                Alt-F               FILL PARA
  3741.                Alt-H               ALTHELP
  3742.                Alt-J               JUSTIFY PARA
  3743.                Alt-K               DEFINE KEY
  3744.                Alt-M               SET MARGINS
  3745.                Alt-P               SET PINDENT
  3746.                Alt-Q               QUIT
  3747.                Alt-R               REPLACE
  3748.                Alt-S               SET SCOPE
  3749.                Alt-V               SET VIDEO
  3750.  
  3751.                Home                MOVE HOME
  3752.                End                 MOVE END
  3753.                Up                  MOVE UP
  3754.                Down                MOVE DOWN
  3755.                Left                MOVE LEFT
  3756.                Right               MOVE RIGHT
  3757.                PgUp                PREV SCREEN
  3758.                PgDn                NEXT SCREEN
  3759.                Ins                 CHANGE MODE
  3760.                Del                 ERASE CHAR
  3761.                Ctrl-Left           SHIFT LEFT
  3762.                Ctrl-Right          SHIFT RIGHT
  3763.                Ctrl-PgUp           EXECUTE EMCOTHUP
  3764.                Ctrl-PgDn           EXECUTE EMCOTHDN
  3765.  
  3766.  
  3767.  
  3768.  
  3769.  
  3770.  
  3771.  
  3772.  
  3773.  
  3774.  
  3775.  
  3776.  
  3777.  
  3778.  
  3779.                                         - 62 -
  3780.  
  3781.  
  3782.  
  3783.                                  A P P E N D I C E S
  3784.  
  3785.                                 B. The DOS Environment
  3786.  
  3787.         Most PC users are familiar with the DOS PATH command. A statement
  3788.         of the form
  3789.  
  3790.             PATH=C:\;C:\DOS\;C:\PEDIT
  3791.  
  3792.         in your AUTOEXEC file tells DOS where to look for programs and
  3793.         batch files. Unfortunately, the DOS environment is a mystery to
  3794.         most.
  3795.  
  3796.         Environment variables are defined using the SET command at the DOS
  3797.         prompt. The command "SET" by itself displays a list of all defined
  3798.         variables while "SET NAME=VALUE" defines a variable. Programs can
  3799.         read these environment variables and get access to the equivalence
  3800.         value. Adding a line such as:
  3801.  
  3802.              SET PEDIT=C:\PEDIT
  3803.  
  3804.         to your AUTOEXEC.BAT file lets pEDIT find its initialization and
  3805.         help files no matter what device/directory you are in. Note that
  3806.         only a device and directory are specified.
  3807.  
  3808.         Following is a sample AUTOEXEC.BAT file showing the DOS PATH and
  3809.         the PEDIT environment variable. Note that these items *must* be
  3810.         defined before entering a DOS shell such as HDM; if they were
  3811.         after "HDM" in this case, the statements would never be executed.
  3812.  
  3813.                 PATH=C:\;C:\DOS;C:\WINDOWS;C:\PEDIT
  3814.                 SET PEDIT=C:\PEDIT
  3815.                 CD \HDM
  3816.                 HDM
  3817.  
  3818.         DOS allocates only a relatively small amount of memory for the
  3819.         environment and it is possible to exceed this. The error is 'Out
  3820.         of environment space' while booting. If this happens and you have
  3821.         DOS 3.1 or higher, add the following line to your CONFIG.SYS file
  3822.         to reserve more space:
  3823.  
  3824.              SHELL=C:\DOS\COMMAND.COM C:\DOS /E:nnn /P
  3825.  
  3826.         Substitute your device and path in place of C:\DOS. For DOS 3.1,
  3827.         use /E:16 to reserve 16 paragraphs or 256 bytes. For DOS 3.2 or
  3828.         higher, specify /E:256.
  3829.  
  3830.         In DOS Version 2, unfortunately, there is no way to increase the
  3831.         environment space. You have no alternative here but to, for ex-
  3832.         ample, shorten the DOS PATH.
  3833.  
  3834.  
  3835.  
  3836.                                         - 63 -
  3837.  
  3838.  
  3839.  
  3840.                                  A P P E N D I C E S
  3841.  
  3842.                              C. Supported Video Displays
  3843.  
  3844.                                         1. MDA
  3845.  
  3846.         The Monochrome Display Adapter is the original text-only display.
  3847.         It supports only two 'colors' such as black and white or black and
  3848.         green. pEDIT+ can only run in text mode on this type of display.
  3849.  
  3850.  
  3851.                                         2. HGA
  3852.  
  3853.         The Hercules Graphics Adapter provides monochrome graphics on a
  3854.         monochrome display. Unfortunately, the fast text display routines
  3855.         used by pEDIT do not support the standard 80x25 mode, so users
  3856.         with Hercules displays can run in text mode only.
  3857.  
  3858.  
  3859.                                         3. CGA
  3860.  
  3861.         The Color Graphics Adapter was the first color display that
  3862.         supported graphics. The resolution is horrible and colors are
  3863.         limited to two palettes of 4 colors each in low-res (40 column)
  3864.         mode, and only 2 colors in high-res mode. pEDIT runs in hi-res
  3865.         640x200 mode on a CGA monitor; the text resolution (8x8 cell) is
  3866.         horrible also. The extended characters above Ascii 127 are not
  3867.         available in CGA graphics mode.
  3868.  
  3869.  
  3870.                                         4. EGA
  3871.  
  3872.         The Enhanced Graphics Adapter provides MUCH better graphics and
  3873.         text resolution than the CGA. Graphics mode displays 640x350 dots,
  3874.         and text uses a 8x14 cell. Sixteen colors are available on color
  3875.         displays. A minimum of 256k of EGA memory is required; some very
  3876.         old EGA cards have only 64k.
  3877.  
  3878.         An EGA display can also be attached to an IBM monochrome adapter.
  3879.         pEDIT PLUS supports this configuration, but with only 2 text
  3880.         colors possible. The only valid combination is black on white.
  3881.  
  3882.  
  3883.                                         5. VGA
  3884.  
  3885.         The Video Graphics Array offers a slightly better resolution
  3886.         (640x480) than EGA. pEDIT PLUS runs a VGA display in EGA mode to
  3887.         be compatible with the standard 80x25 text mode.
  3888.  
  3889.         Sixteen colors are available on color displays. A VGA display can
  3890.         also be attached to an IBM monochrome adapter. pEDIT supports this
  3891.  
  3892.  
  3893.                                         - 64 -
  3894.  
  3895.  
  3896.  
  3897.         configuration as above with black on white again being the only
  3898.         valid color combination.
  3899.  
  3900.  
  3901.                                        6. MCGA
  3902.  
  3903.         The MultiColor Graphics Array was supplied with some low-end PS/2
  3904.         models. It provides CGA modes plus the VGA 640x480 2-color mode.
  3905.         pEDIT can run the MCGA only in CGA 2 color mode; unfortunately,
  3906.         MCGA users will be stuck with the low resolution of this mode.
  3907.  
  3908.  
  3909.                                        7. Other
  3910.  
  3911.         You should be able to run pEDIT PLUS in graphics mode on any
  3912.         display that supports a VGA-compatible mode. You may have to force
  3913.         your system into VGA mode before starting up pEDIT; refer to the
  3914.         manuals that came with your display and/or adapter card for more
  3915.         information.
  3916.  
  3917.  
  3918.  
  3919.  
  3920.  
  3921.  
  3922.  
  3923.  
  3924.  
  3925.  
  3926.  
  3927.  
  3928.  
  3929.  
  3930.  
  3931.  
  3932.  
  3933.  
  3934.  
  3935.  
  3936.  
  3937.  
  3938.  
  3939.  
  3940.  
  3941.  
  3942.  
  3943.  
  3944.  
  3945.  
  3946.  
  3947.  
  3948.  
  3949.  
  3950.                                         - 65 -
  3951.  
  3952.  
  3953.  
  3954.                                  A P P E N D I C E S
  3955.  
  3956.                                 D. Initialization File
  3957.  
  3958.         pEDIT requires an initialization file at startup. This file must
  3959.         either be located in the current directory or be available through
  3960.         translation of the DOS environment variable PEDIT. The default
  3961.         init file is named PEDIT.INI; pEDIT looks for this file unless you
  3962.         specify an alternate by including @XXX on the command line, where
  3963.         XXX = EMC, QUI, STD, WPF or WST.
  3964.  
  3965.         Five sample initialization files are included:
  3966.  
  3967.             STD        Standard--pEDIT's own; now CUA-compliant with <F01>
  3968.                        = Help, <Shift-Del> = cut, <Shift-Ins> = paste, etc.
  3969.  
  3970.             WST        WordStar--the first PC word processor; many people
  3971.                        know the WordStar keys and LOTS of software still
  3972.                        uses these obscure key definitions
  3973.  
  3974.             WPF        WordPerfect--still the top seller, complete with
  3975.                        its finger-tangling assortment of meaningless Shift-,
  3976.                        Ctrl- and Alt- keys
  3977.  
  3978.             QUI        Quick--Microsoft's Quick Editor, used by the Quick
  3979.                        Compilers and the DOS 5 Editor; an example is the
  3980.                        combination <Alt-F+O> = Open file
  3981.  
  3982.             EMC        Emacs--the famous UNIX programmer's editor; uses
  3983.                        mnemonics, i.e. <Esc+F> = word forward, <Esc+B> =
  3984.                        word back
  3985.  
  3986.         An initialization file is a text file containing any combination
  3987.         of the following commands: DEFINE_SHIFT(), DEFINE_KEY(), SET() and
  3988.         EXECUTE(). Note the underscore between words and the parentheses.
  3989.         The commands can be uppercase, lowercase or mixed. The editor
  3990.         ignores blank lines and treats anything after an exclamation point
  3991.         as a comment.
  3992.  
  3993.         Unlike other editors, pEDIT uses English key names. You don't have
  3994.         to try and remember what '@' and '#' stand for. pEDIT uses the
  3995.         names shown on the keys: Shift, Ctrl and Alt.
  3996.  
  3997.         DEFINE_SHIFT is used to define a shift or 'lead-in' key and tells
  3998.         pEDIT that the key will be the first key of a multi-key command.
  3999.         For example, DEFINE_SHIFT (Ctrl-Q) sets up Ctrl-Q as one of Word-
  4000.         Star's lead-in keys. The shift keys must be defined at the top of
  4001.         the init file before any key definitions that use that shift key.
  4002.  
  4003.         DEFINE_KEY defines a key. Obviously, no one would want to have to
  4004.         define each key every time they wanted to edit something, so these
  4005.  
  4006.  
  4007.                                         - 66 -
  4008.  
  4009.  
  4010.  
  4011.         bindings should be in the iniitialization file. The statement
  4012.         DEFINE_KEY (Get_File, Alt-G) binds the key Alt-G to the procedure
  4013.         GET FILE. A plus (+) sign between two key names indicates a two
  4014.         key command. For example, the statement DEFINE_KEY (Find, Ctrl-
  4015.         Q+F) defines WordStar's FIND key.
  4016.  
  4017.         SET is used to define the editing environment. If you wanted pEDIT
  4018.         to always come up in color using blue on a white background, you
  4019.         would include SET (COLOR, BLU, WHT) in the initialization file.
  4020.         This would be the same as entering the command "SET COLOR blu wht"
  4021.         from within pEDIT.
  4022.  
  4023.         EXECUTE is used to auto-execute a macro at startup time. If you
  4024.         wanted to execute a macro named LETTER every time you started
  4025.         pEDIT, for example, you would add EXECUTE (letter) to your INI
  4026.         file.
  4027.  
  4028.         Again, you don't have to use any of the initialization files
  4029.         supplied with the editor. You can set up any keyboard mapping you
  4030.         want.
  4031.  
  4032.  
  4033.                                     E. Help Files
  4034.  
  4035.         The Help File PEDIT.HLP is required if you want to use the HELP
  4036.         function. This file contains fixed 78-byte records. The editor
  4037.         uses random file access to read the help file so it must be made
  4038.         up of fixed-length records.
  4039.  
  4040.         You can customize the Help File as long as you keep the length of
  4041.         each record at exactly 78 bytes by 'padding' with spaces. You will
  4042.         need to limit each command's text to 19 lines (one screenful) of
  4043.         text. If you look at the file, you will see the first record for a
  4044.         command starts with two carets plus the command name in caps - for
  4045.         example "^^MOVE UP".
  4046.  
  4047.         The editor uses the optional files PEDIT.BTN and PEDIT.KEY for the
  4048.         ALTHELP command. When this command is invoked, pEDIT displays the
  4049.         contents of the these two files in BUTTON and KEYBOARD windows,
  4050.         respectively. pEDIT PLUS comes with five sample Keyboard Help
  4051.         Files corresponding to the five Initialization Files listed above.
  4052.         You can customize the Keyboard Help File any way you want.
  4053.  
  4054.  
  4055.  
  4056.  
  4057.  
  4058.  
  4059.  
  4060.  
  4061.  
  4062.  
  4063.  
  4064.                                         - 67 -
  4065.  
  4066.  
  4067.  
  4068.                                  A P P E N D I C E S
  4069.  
  4070.                                     F. Color Codes
  4071.  
  4072.  
  4073.              BLK                   Black
  4074.              BLU                   Blue
  4075.              GRN                   Green
  4076.              CYN                   Cyan
  4077.              RED                   Red
  4078.              MAG                   Magenta
  4079.              BRN                   Brown
  4080.              WHT                   White
  4081.              GRY                   Grey
  4082.              LBL                   Light Blue
  4083.              LGR                   Light Green
  4084.              LCY                   Light Cyan
  4085.              LRD                   Light Red (Pink)
  4086.              LMG                   Light Magenta
  4087.              YEL                   Yellow
  4088.              BWH                   Bright White
  4089.  
  4090.  
  4091.         The light colors are also called bright or intense. Only certain
  4092.         combinations are legal for VGA/EGA color displays. The foreground
  4093.         color can be any of the 16 listed above; the background, however,
  4094.         is limited to the normal (non-intense) colors.
  4095.  
  4096.  
  4097.  
  4098.  
  4099.  
  4100.  
  4101.  
  4102.  
  4103.  
  4104.  
  4105.  
  4106.  
  4107.  
  4108.  
  4109.  
  4110.  
  4111.  
  4112.  
  4113.  
  4114.  
  4115.  
  4116.  
  4117.  
  4118.  
  4119.  
  4120.  
  4121.                                         - 68 -
  4122.  
  4123.  
  4124.  
  4125.                                  A P P E N D I C E S
  4126.  
  4127.                                   G. Troubleshooting
  4128.  
  4129.  
  4130.                         1. pEDIT can't find the files it needs
  4131.  
  4132.         If you see the error "Initialization file not found" when starting
  4133.         pEDIT, there is a serious problem. pEDIT *MUST* be installed on
  4134.         your system for it to function properly. If pEDIT has indeed been
  4135.         installed, check your AUTOEXEC.BAT file to make sure the "SET
  4136.         PEDIT=" statement is being executed. The section titled 'The DOS
  4137.         Environment' has more information.
  4138.  
  4139.  
  4140.                           2. The screen is blank or garbage
  4141.  
  4142.         pEDIT cannot correctly identify your video display type. Adding
  4143.         the line "SET (DISPLAY, n)" to your PEDIT.INI file will force
  4144.         pEDIT to use the specified mode. Try text mode (n = 0) first; then
  4145.         try other values of n. See the SET DISPLAY command for a list of
  4146.         valid display numbers.
  4147.  
  4148.  
  4149.                             3. No mouse pointer at startup
  4150.  
  4151.         pEDIT could not detect a Microsoft compatible mouse driver. The
  4152.         mouse driver must be installed either at system startup by placing
  4153.         the statement "DEVICE=d:\path\MOUSE.SYS" in the file CONFIG.SYS,
  4154.         or from the DOS command line by executing the MOUSE program.
  4155.  
  4156.  
  4157.                              4. Mouse pointer disappears
  4158.  
  4159.         If this should happen, press any key or click the left mouse
  4160.         button to restore the pointer.
  4161.  
  4162.  
  4163.                               5. ButtonBar not graphical
  4164.  
  4165.         There are several possibilities: (1) you have a text-only display;
  4166.         (2) you are using a Hercules monochrome graphics adapter or (3)
  4167.         the program cannot find the ButtonBar image file "PEDIT.BAR".
  4168.  
  4169.  
  4170.                                  6. ButtonBar trashed
  4171.  
  4172.         The most likely cause for this is having the wrong ButtonBar image
  4173.         file installed. pEDIT expects you to have one and only one display
  4174.         in use. If the image file is somehow lost, you can get it back
  4175.         from the distribution disk.
  4176.  
  4177.  
  4178.                                         - 69 -
  4179.  
  4180.  
  4181.  
  4182.                         7. Invalid drive or drive unavailable
  4183.  
  4184.         You have referenced a drive that doesn't exist or a floppy drive
  4185.         is not available, i.e. no diskette is loaded or the latch is open.
  4186.  
  4187.  
  4188.                          8. Garbage in printed documentation
  4189.  
  4190.         PEDIT.DOC uses the special characters above Ascii 127 for line and
  4191.         box drawing. A printer that supports the IBM Extended Character
  4192.         Set is required to print this document. Many printers including
  4193.         the HP LaserJet can print these characters but must be configured
  4194.         to do so; refer to your printer manual.
  4195.  
  4196.         If your printer cannot handle these special characters, use the
  4197.         new DRAW command to convert them to standard Ascii characters.
  4198.  
  4199.  
  4200.                        9. Blank pages in printed documentation
  4201.  
  4202.         The pEDIT documentation contains form feeds to facilitate print-
  4203.         ing. Unfortunately, many printers add their own form feeds to skip
  4204.         over page perforations. Please Refer to your printer manuals to
  4205.         see how to turn off the auto form feeding.
  4206.  
  4207.  
  4208.                               10. Can't use DOS command
  4209.  
  4210.         pEDIT "swaps" all text to disk before shelling to DOS. If there is
  4211.         not enough free disk space to hold the swap files, the function
  4212.         will be cancelled.
  4213.  
  4214.  
  4215.                        11. System hangs after using DOS command
  4216.  
  4217.         A good guess is that you executed a TSR (Terminate and Stay Res-
  4218.         ident) program when shelled to DOS. These TSRs must be loaded at
  4219.         startup time before you run any other programs.
  4220.  
  4221.  
  4222.                     12. Screen garbled after shelling DOS command
  4223.  
  4224.         For some unknown reason, DOS error messages such as "File not
  4225.         found" are NOT redirected to PED$$.TMP and can overwrite the pEDIT
  4226.         screen. Use the REFRESH SCREEN command to restore the screen.
  4227.  
  4228.  
  4229.                         13. Cursor disappears in graphics mode
  4230.  
  4231.         Because there is no hardware cursor in graphics mode, pEDIT must
  4232.         maintain its own. If the cursor state is lost, the cursor will
  4233.  
  4234.  
  4235.                                         - 70 -
  4236.  
  4237.  
  4238.  
  4239.         disappear. Sometimes the cursor can be restored by shelling to DOS
  4240.         and returning. If this doesn't work, you must quit and restart the
  4241.         program.
  4242.  
  4243.  
  4244.                             14. PRINT commands don't work
  4245.  
  4246.         PRINT only works in Registered versions of pEDIT PLUS. If you have
  4247.         registered, you must also have DOS 3.0 or higher and the DOS PRINT
  4248.         program must be installed. If you are still using the old DOS 2.x
  4249.         you should consider upgrading to DOS 5.0.
  4250.  
  4251.  
  4252.                       15. pEDIT "hangs" during a PRINT operation
  4253.  
  4254.         If the printer is off-line or out of paper when you issue the
  4255.         PRINT DELETE and PRINT CANCEL commands, pEDIT may appear to hang.
  4256.         If you put the printer back on-line, pEDIT will resume.
  4257.  
  4258.  
  4259.                          16. Garbage with EGA display adapter
  4260.  
  4261.         A minimum of 256k of EGA video memory is required for 16 colors;
  4262.         the original EGA adapter had only 64k. You will have to use pEDIT
  4263.         in text mode by including 'SET (DISPLAY, 0)' in your INI file.
  4264.  
  4265.  
  4266.  
  4267.  
  4268.  
  4269.  
  4270.  
  4271.  
  4272.  
  4273.  
  4274.  
  4275.  
  4276.  
  4277.  
  4278.  
  4279.  
  4280.  
  4281.  
  4282.  
  4283.  
  4284.  
  4285.  
  4286.  
  4287.  
  4288.  
  4289.  
  4290.  
  4291.  
  4292.                                         - 71 -
  4293.  
  4294.  
  4295.  
  4296.                                  A P P E N D I C E S
  4297.  
  4298.                                       H. RAMEDIT
  4299.  
  4300.  
  4301.         RAMEDIT is a new feature that lets you install auxillary pEDIT
  4302.         files on a RAM disk for faster operation. You should consider
  4303.         using RAMEDIT if you have a slow hard drive. You can disregard
  4304.         this section if you don't have software such as Microsoft's Smart-
  4305.         Drive that lets you emulate a disk drive in memory.
  4306.  
  4307.         RAMEDIT is a batch file that lets you install (or deinstall) the
  4308.         Initialization, Help, macro and other files to (from) a RAM drive.
  4309.         The executable is not copied. The pEDIT environment variable is
  4310.         also changed to point either to the RAM disk or the normal path.
  4311.  
  4312.         pEDIT PLUS will operate much faster this way because reading from
  4313.         memory is always faster than reading from a disk. You will see
  4314.         improvement in the time it takes to read the INI file, open the
  4315.         help file, and execute a macro. The DOS command in particular is
  4316.         much faster because the temp files can be written to the RAM disk.
  4317.  
  4318.           You may have to edit RAMEDIT.BAT for it to work correctly on
  4319.         your system. The supplied file is set up for the Standard config-
  4320.         uration and to use RAM Drive "D". Also, you will lose your updated
  4321.         PEDIT.INF file containing the last file you edited unless it is
  4322.         copied to your hard drive. You should consider having a shutdown
  4323.         batch file that does this and parks your hard drive heads. Please
  4324.         refer to the file RAMEDIT.BAT itself for more information.
  4325.  
  4326.         The syntax (with the file RAMEDIT.BAT in your DOS PATH) is:
  4327.  
  4328.             >RAMEDIT I             (to install
  4329.             >RAMEDIT D             (to deinstall
  4330.  
  4331.         Use the (D)einstall option if you need to free up space on your
  4332.         RAM drive before e.g. running Microsoft Windows.
  4333.  
  4334.         You can, if you wish, copy PEDIT.EXE to the RAM drive for even
  4335.         faster operation. It is strongly recommended that data files NOT
  4336.         be moved to the RAM drive for editing. They will load (and save)
  4337.         faster BUT you run the risk of losing your work if the computer
  4338.         hangs or you power off your system without copying the files to
  4339.         permanent storage.
  4340.  
  4341.  
  4342.  
  4343.  
  4344.  
  4345.  
  4346.  
  4347.  
  4348.  
  4349.                                         - 72 -
  4350.  
  4351.  
  4352.  
  4353.                                       I N D E X
  4354.  
  4355.  
  4356.         A
  4357.  
  4358.         ASCII  1, 12, 19, 21, 36, 47, 54, 56, 58, 59, 62, 64, 70
  4359.         AUTOEXEC  5, 6, 7, 46, 63, 69
  4360.  
  4361.         B
  4362.  
  4363.         BIOS  2, 43
  4364.         Batch File  4, 48, 63, 72
  4365.         Binary  1
  4366.         Boot  5, 6, 7, 43, 63
  4367.         Buffer Commands  27
  4368.         ButtonBar  1, 2, 3, 9, 13, 14, 17, 35, 40, 69
  4369.  
  4370.         C
  4371.  
  4372.         CGA  1, 3, 13, 37, 38, 64, 65
  4373.         COMMAND Buffer  1, 12, 27, 35
  4374.         COMMAND.COM  8, 63
  4375.         CUA  2, 43, 53, 66
  4376.         Click (Mouse)  2, 12, 13, 15, 16, 17, 25, 27, 29, 39, 45, 69
  4377.         Color  1, 3, 13, 37, 38, 50, 57, 64, 65, 67, 68
  4378.         Command Mode  12, 14, 35
  4379.         Commands ABORT  13, 23, 25, 27, 35, 36, 37, 39, 45
  4380.         Commands ALTHELP  12, 39
  4381.         Commands AUTO INDENT  20
  4382.         Commands BUFFER  14, 16, 27, 35, 46
  4383.         Commands CAPITAL WORD  21
  4384.         Commands CENTER LINE  20
  4385.         Commands CHANGE DIR  27
  4386.         Commands CHANGE MODE  27
  4387.         Commands DEFINE KEY  36
  4388.         Commands DEFINE SHIFT  36
  4389.         Commands DO BUTTON  35
  4390.         Commands DO COMMAND  12, 14, 23, 35, 36, 42, 50
  4391.         Commands DOS  14, 39, 44, 48, 50
  4392.         Commands DRAW  14, 36, 45
  4393.         Commands ERASE CHAR  13, 22
  4394.         Commands ERASE LINE  22
  4395.         Commands ERASE PREV  13, 22
  4396.         Commands ERASE WORD  22
  4397.         Commands EXECUTE  33, 34, 41
  4398.         Commands EXIT  39, 40, 44
  4399.         Commands FILL PARA  14, 19
  4400.         Commands FIND  14, 21, 23, 24, 27, 35, 38, 49
  4401.         Commands FINDNEXT  14, 23, 27, 35
  4402.         Commands GET FILE  14, 25
  4403.         Commands GOTO MARK  28
  4404.         Commands HELP  10, 12, 14, 16, 35, 39
  4405.  
  4406.  
  4407.  
  4408.         Commands INCLUDE FILE  25
  4409.         Commands INDENT  19, 20, 38, 46
  4410.         Commands INSERT CHAR  19, 25
  4411.         Commands INSERT HERE  14, 32
  4412.         Commands JUSTIFY PARA  14, 19
  4413.         Commands LEARN  33
  4414.         Commands LEFT LINE  20
  4415.         Commands LINE  19, 20, 22, 28, 29, 38
  4416.         Commands LIST ASCII  21, 36
  4417.         Commands LIST KEYS  12, 36
  4418.         Commands LOWER WORD  21
  4419.         Commands MARK  27, 28
  4420.         Commands MOVE ABSOLUTE  17
  4421.         Commands MOVE BOTTOM  17
  4422.         Commands MOVE DOWN  18, 35, 37, 45
  4423.         Commands MOVE END  13, 17, 37, 45
  4424.         Commands MOVE HOME  13, 17, 37, 45
  4425.         Commands MOVE LEFT  13, 18, 37, 45
  4426.         Commands MOVE RIGHT  13, 18, 37, 45
  4427.         Commands MOVE TOP  17
  4428.         Commands MOVE UP  13, 17, 35, 37, 45
  4429.         Commands MOVE WORD  18, 27
  4430.         Commands NEXT LINE  29
  4431.         Commands NEXT SCREEN  30
  4432.         Commands ONE WINDOW  29
  4433.         Commands OPEN LINE  19
  4434.         Commands OTHER WINDOW  29
  4435.         Commands PREV LINE  29
  4436.         Commands PREV SCREEN  29
  4437.         Commands PRINT  38, 39, 44, 46
  4438.         Commands QUIT  14, 40
  4439.         Commands QUOTE CHAR  21
  4440.         Commands RECALL  35
  4441.         Commands REFRESH SCREEN  35
  4442.         Commands REMEMBER  33
  4443.         Commands REMOVE TEXT  14, 22, 31
  4444.         Commands RENAME FILE  25, 26, 50
  4445.         Commands REPEAT  33, 35, 37
  4446.         Commands REPLACE  14, 23, 27, 35, 38
  4447.         Commands RESTORE TEXT  22
  4448.         Commands RIGHT LINE  20
  4449.         Commands RULER  40
  4450.         Commands SAVE MACRO  33, 41
  4451.         Commands SELECT TEXT  31
  4452.         Commands SET AUTOSAVE  37
  4453.         Commands SET COLOR  37
  4454.         Commands SET CURSOR  37
  4455.         Commands SET DISPLAY  37
  4456.         Commands SET LINES  38
  4457.         Commands SET MARGINS  12, 19, 20, 38
  4458.         Commands SET PINDENT  19, 38
  4459.         Commands SET SCOPE  23, 38
  4460.  
  4461.  
  4462.  
  4463.         Commands SET VIDEO  38
  4464.         Commands SHIFT LEFT  14, 30
  4465.         Commands SHIFT RIGHT  14, 30
  4466.         Commands SHOW BUFFER  14, 27
  4467.         Commands SHOW KEY  36
  4468.         Commands SHOW PRINTER  39, 46
  4469.         Commands STORE TEXT  22, 31
  4470.         Commands TRANS CHAR  21
  4471.         Commands TRIM BUFFER  27
  4472.         Commands TWO WINDOWS  29
  4473.         Commands UPPER WORD  21
  4474.         Commands WIPE TEXT  31
  4475.         Commands WRITE FILE  12, 14, 25, 37
  4476.         Configuration  1, 2, 3, 4, 5, 8, 12, 41, 42, 43, 50, 52, 64
  4477.         CONFIG.SYS  63, 69
  4478.         Copyright  51
  4479.         Cursor  15, 16, 17, 37
  4480.         Cursor Movement  17
  4481.         Cut and Paste  31
  4482.  
  4483.         D
  4484.  
  4485.         DOS Buffer  1, 39, 48, 49
  4486.         DOS PATH  5, 6, 8, 63, 72
  4487.         Disk Macro  4, 33, 34, 41, 42, 48
  4488.         Diskette  3, 5, 6, 50, 70
  4489.         Distribution  3, 5, 6, 7, 69
  4490.         Double Click (Mouse)  2, 15, 25, 27, 39
  4491.         Drag (Mouse)  2, 15, 31
  4492.         Drawing  1, 14, 36, 37, 45, 70
  4493.  
  4494.         E
  4495.  
  4496.         EGA  1, 3, 4, 10, 13, 20, 37, 38, 48, 64, 68, 72
  4497.         EMACS  1, 3, 4, 5, 8, 61, 66
  4498.         EMC  3, 8, 41, 62, 66
  4499.         Environment  1, 5, 6, 8, 63, 66, 67, 69, 72
  4500.  
  4501.         F
  4502.  
  4503.         File Commands  25
  4504.         Floppy  1, 5, 6, 8, 70
  4505.  
  4506.         G
  4507.  
  4508.         Global Scope  1, 9, 10, 23, 38, 54
  4509.  
  4510.         H
  4511.  
  4512.         HDM  4, 63
  4513.         Hard Disk  6, 7
  4514.         Hard Drive  2, 5, 6, 8, 72
  4515.  
  4516.  
  4517.  
  4518.         Help File  3, 4, 5, 39, 63, 67, 72
  4519.         Hercules  1, 64, 69
  4520.  
  4521.         I
  4522.  
  4523.         INSTALL  3, 4, 5, 6, 7, 50
  4524.         Initialization file  4, 10, 35, 36, 38, 50, 66, 67, 69
  4525.  
  4526.         K
  4527.  
  4528.         KEYRATE  4, 5, 6, 7
  4529.         Key Macro  33, 34, 41
  4530.         Keyboard Help File  4, 67
  4531.  
  4532.         L
  4533.  
  4534.         Line and Box Drawing  1, 45
  4535.         Local Scope  10, 23, 38, 54
  4536.  
  4537.         M
  4538.  
  4539.         MCGA  65
  4540.         MS Quick  5
  4541.         Macro  4, 33, 34, 41, 42, 47, 48, 49, 67, 72
  4542.         Memory  1, 2, 5, 10, 17, 25, 31, 44, 46, 50, 63, 72
  4543.         Miscellaneous Commands  35
  4544.         Mouse  1, 2, 12, 13, 15, 16, 17, 25, 29, 31, 33, 35, 39, 44, 45, 69
  4545.         Mouse Button  15, 25, 33, 39
  4546.  
  4547.         P
  4548.  
  4549.         PATH  5, 6, 7, 8, 33, 39, 40, 41, 44, 63, 72
  4550.         PED$$$n.TMP  44
  4551.         PED$$.PRN  47
  4552.         PED$$.TMP  48, 70
  4553.         PEDIT PATH  8, 33, 39, 40, 41, 44
  4554.         PEDIT.BAR  69
  4555.         PEDIT.BTN  3, 8, 40, 67
  4556.         PEDIT.DOC  3, 70
  4557.         PEDIT.EXE  3, 8, 72
  4558.         PEDIT.HLP  3, 8, 39, 67
  4559.         PEDIT.INI  5, 8, 50, 66, 69
  4560.         PEDIT.KEY  5, 8, 40, 67
  4561.         PEDIT.SHR  3
  4562.         Pointer (Mouse)  15, 16, 17, 31, 69
  4563.         Print Queue  39, 46
  4564.         Printing  39, 46
  4565.         Prompting Mode  12
  4566.  
  4567.         Q
  4568.  
  4569.         QUI  3, 8, 14, 40, 41, 54, 55, 56, 57, 58, 60, 61, 62, 66
  4570.  
  4571.  
  4572.  
  4573.         R
  4574.  
  4575.         Reformat Paragraph  14
  4576.         Register  3, 4, 5, 17, 39, 46, 51, 71
  4577.         Registration  51
  4578.         Repaginate  47
  4579.  
  4580.         S
  4581.  
  4582.         STAYDOWN  4, 5, 6, 7
  4583.         STD  2, 3, 8, 41, 42, 43, 53, 66
  4584.         Scope  10, 23, 38, 54, 56, 58, 62
  4585.         Scroll  2, 10, 15, 16, 17, 18, 29, 30, 31, 35, 38, 41, 42
  4586.         Searching  12, 23
  4587.         Shareware  1, 4, 46, 51
  4588.         Shell  1, 14, 39, 44, 46, 48, 50, 63, 70, 71
  4589.         Special Char  21
  4590.         Standard  2, 3, 4, 5, 8, 12
  4591.  
  4592.         T
  4593.  
  4594.         TSR  43, 44, 46, 70
  4595.         Text Deletion  22
  4596.         Text Manipulation  19
  4597.         Troubleshooting  69
  4598.         Tutorial  3, 5
  4599.  
  4600.         U
  4601.  
  4602.         Undo  22, 31
  4603.  
  4604.         V
  4605.  
  4606.         VGA  1, 3, 10, 13, 37, 38, 64, 65, 68
  4607.         Video Display  38, 64, 69
  4608.  
  4609.         W
  4610.  
  4611.         WPF  3, 8, 41, 57, 58, 66
  4612.         WST  3, 8, 41, 55, 56, 66
  4613.         Window Commands  29
  4614.         WordPerfect  1, 4, 43
  4615.         Wordstar  1, 3, 4, 5, 8, 35, 51, 55, 66, 67
  4616.